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Notices 


References in this publication to products or services of IBM do not suggest or 
imply that IBM will make them available in all countries where IBM does business 
or that only products or services of IBM may be used. Noninfringing equivalents 
may be substituted, but the user must verify that such substitutes, unless expressly 
designated by IBM, work correctly. No license, expressed or implied, to patents or 
copyrights of IBM is granted by furnishing this document. You can send license 
inquiries, in writing, to the IBM Director of Licensing, IBM Corporation, 500 
Columbus Avenue, Thornwood, NY 10594, USA. 


Licensees of this program who wish to have information about it for the purpose 
of enabling: (1) the exchange of information between independently created 
programs and other programs (including this one) and (2) the mutual use of the 
information, which has been exchanged, should contact: IBM Corporation, Printing 
Systems Company Legal Department, Mail Drop 001W, Boulder, Colorado 80301 
USA. Such information may be available, subject to appropriate terms and 
conditions, including in some cases, payment of a fee. 


Trademarks and Service Marks 


The following terms, denoted by an asterisk (*) in this publication, are trademarks 
of the IBM Corporation in the United States or other countries or both: 


Advanced Function Presentation OS/2 

Advanced Function Printing OS/400 

AFP Personal Computer AT 
Application System /400 Personal System /2 
AS/400 Print Services Facility 
BCOCA PSF 

GDDM System /370 

IBM 400 

IPDS iSeries 

MAPICS 


Other company, product and service names, which may be denoted by a double 
asterisk (**), may be trademarks or service marks of others. 
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About IBM Advanced Function Printing Utilities for iSeries 


The IBM Advanced Function Printing Utilities for iSeries (AFP/U), Version 5 
Release 2, is a licensed program consisting of three integrated modules that 
provide support for Advanced Function Printing (AFP) applications on iSeries. 
This book describes how to use the AFP Utilities for iSeries. It includes detailed 
reference information as well as extensive examples. 


This book consists of the following parts. 


* Introduction to IBM Advanced Function Printing Utilities for iSeries 
introduces the concept of AFP Utilities for iSeries and provides general 
information. 


* Overlay Utility provides detailed information about the Overlay Utility, helps 
you decide how to use the Overlay Utility, and provides practical exercises. 


* Print Format Utility provides detailed information about the Print Format 
Utility, and describes how to use the Print Format Utility with practical 
exercises. 


* Design Operation and Fonts provides detailed information about designing 
elements in an overlay, in a record layout, and in a page layout. It also provides 
detailed information about the fonts that you can use for the Overlay Utility and 
Print Format Utility. 


* Resource Management Utility provides detailed information about the Resource 
Management Utility, and describes how to use the Resource Management Utility 
with practical exercises. 

¢ Reference describes the AFP Utilities for iSeries commands, the limitations and 
restrictions of the AFP Utilities for iSeries program, and provides problem 
analysis information. 


Practice exercises described in the "Getting Started with ..." chapters enable you to 
quickly become familiar with AFP Utilities for iSeries. After the exercises, see the 
detailed information to do more complex tasks. The best resource for learning 
about AFP applications on iSeries is the iSeries Guide to Advanced Function 
Presentation and Print Services Facility, 5544-5319. 

The following iSeries books contain information you may need. 


CL Reference, SC41-4722, provides the information about the CL commands. 


Printer Device Programming, SC41-4713, provides the information about printing on 
the iSeries system. 


Advanced Function Presentation: Printer Information, S544-3290, provides general 
information about AFP printers, their characteristics, and resident fonts. 


IBM Printing Systems: Printer Information, 544-5750, provides general information 
about IBM Printing Systems printers, their characteristics, and resident fonts. 


For information about other iSeries publications, see either of the following: 
* The Publications Reference book, SC41-4003, in the iSeries Softcopy Library. 
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* The AS/400 Information Directory, a unique, multimedia interface to a searchable 
database containing descriptions of titles available from IBM or from selected 
other publishers. The AS/400 Information Directory is shipped with your system at 
no charge. 


Who Should Use This Book 


This book is intended for iSeries users, such as system administrators, system 
programmers, and anyone who uses the iSeries system. 


Before you use this book, you should be familiar with the introductory material for 


using the iSeries system. You do not need to understand how to use a high-level 
programming language to use AFP Utilities 
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Part 1. Introduction to IBM Advanced Function Printing 
Utilities for iSeries 
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Chapter 1. What are the IBM Advanced Function Printing 
Utilities for iSeries? 


The IBM Advanced Function Printing Utilities for iSeries (AFP/U), Version 4 
Release 2, is a licensed program consisting of three integrated utilities that provide 
support for Advanced Function Printing (AFP) applications on iSeries. These 
utilities enable you to create and manage electronic forms (overlays), to create and 
manage image resources, and to create AFP applications from server database files. 
The three AFP Utilities are: 


Overlay Utility: Enables you to create electronic forms directly on the server for 
use in iSeries AFP applications. The Overlay Utility works with any iSeries 
terminal, providing an interactive design interface. Overlay Utility functions 
include: 


* Create AFP electronic forms from any iSeries terminal 


* Place text, lines, boxes, shading, bar codes, graphics, and page segments at any 
location on the overlay page 


* Present text in a wide variety of fonts using either downloadable fonts 
(iSeries-resident) or printer-resident fonts 


* Present text in either single byte character sets (SBCS) or double byte character 
sets (DBCS) 


* Present text in four orientations (across, down, back, and up) and three formats 
(horizontal, vertical, and vertical right to left) 


* Define horizontal and vertical lines, with control of line type (solid, dashed, or 
dotted) and line thickness 


* Define boxes, with control over box type (solid, dashed, or dotted) and shading 


* Define any of 14 standard bar code symbologies with control over sizing, 
human-readable information, and orientation. Supported bar codes are: 


— 3-of-9 code, MHI/AIM US-3 
— Interleave 2-of-5 
— MSI Plessey 

— Industrial 2-of-5 
— Codabar 

— UPC-A 

— UPC-E 

— EAN-8 

- EAN-13 

— Matrix 2-of-5 

— POSTNET 

— Codel28 

— Japan Postal 

— Royal Mail 


* Position overlay, page segment, and graphic elements by row/column or direct 
page offset in inches or centimeters 


Resource Management Utility: Provides full management of overlay and page 
segment (image) resources. Images scanned on a client workstation can be 
processed, resized, rotated, created, and printed. Resource Management Utility 
functions include: 


* Manage overlays and overlay source files, including print and view options 
* Create page segments from scanned image files, with sizing and rotation options 
* Manage page segments, including print support 


* Convert overlays and page segments to file format for use with client 
workstation applications 


Print Format Utility: Provides an interactive method for creating AFP printing 
applications directly from database files. The Print Format Utility is similar to 
Query for iSeries, but the Print Format Utility is designed for creating AFP output, 
not reports. With the Print Format Utility, complex document applications that 
combine database-driven variable data with overlays, image, bar coding, fonts, and 
other document elements can be produced. Print Format Utility functions include: 


* All of the text, box, line, bar code, graphics, and image functions supported with 
the Overlay Utility 


* Ability to design a record layout and page layout 

* Select records from a database file 

* Place database fields anywhere in the record layout 

* Place variable page segments (images) and graphics in the record layout 
* Replicate the record layout across and down the page 

* Select overlays to be added to each page 

* Specify control breaks for selected fields in the database file 


The AFP Utilities for iSeries provide you the above AFP* functions on the server 
interactively. You can perform your task by selecting options or typing choices on 
the menu display. 


This chapter describes the following: 

* What you can do with AFP Utilities for iSeries 
¢ Functions of AFP Utilities for iSeries 

* Requirements for use of AFP Utilities for iSeries 
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What You Can Do with AFP Utilities for iSeries 


AFP Utilities for iSeries enable you to print a document such as a business letter in 
only one step. In conventional printing, you must load letterhead paper into your 
printer, print the letter texts, and then manually sign the letter. 


Figure 1. Conventional Letter Preparation 


With the AFP Utilities for iSeries, you can electronically store your letterhead and 
signature and print the letterhead, text, and signature all at the same time on blank 
paper already in your IPDS printer. You can also include graphics such as a line 
chart or bar chart in your letter, creating a composite document. 
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L 


THEENCraY — astegycoremy 
Company so aisttar! 


Figure 2. Letter Preparation Using AFP Utilities 


The AFP Utilities provide flexible printing. For example, with AFP Utilities you 
can: 


* Highlight a list of items by printing the list in a different type style from the 
remainder of the text. 


* Print your letterhead in one font and your text in another font. 


You can electronically store your letterhead so it always prints in the same style. 
This printing concept is described in "Using Overlays." 
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Using Overlays 


Overlays are stored constructs of text, boxes, lines, graphics, images, and bar codes 
with all the instructions needed to print. They are often in complex configurations. 
An overlay is always printed in the same format as it was stored in and can be 
positioned anywhere on the page. 


Overlays are useful for letterheads and forms as shown in the following figure. 


Electronically Stored Form Overlay Variable Page Data 


ANY TOWN AMERICA a 
NAME~SERVICE ADDRESS SERVICE PERIOD 
are sony somes 
1225 stoMe STREET 
ANY TOWN. STATE ea o2/o% 
os 5432 
05/01/91 
ACCOUNT NO. 
0130-75152 
sare |wererreaprwes | worn. | x.w.v. | amouwr 
ose 
prusent [PREVIOUS 
cxty snare rrancuzss | ronan tax 
2.27 12 2.49 
> pax tars anounz 64.35 


Merge 


Finished Product 


POWER 


ANY TOWN AMERICA 


NAME-SARVICE ADDRESS SERVICE PERIOD 


FROM 
JOHN JOMES 


1225 STOME STREET 04/02/91 
ANY TOWN. STATE a6 
ennee 05/01/91 


ACCOUNT NO. 
0130-7515-2 


RATE |METER READINGS MULT K.WoM AMOUNT 
USED 
PRESENT | PREVIOUS 
10 1054 1944 10 1:100 51.35 
crTy STATE FRANCHISE TOTAL TAX 
2.27 12 2.49 


> PAY THIS AMOUNT 64.35 


Figure 3. Using Overlays 
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Using Images 


You can place images anywhere on the page. 


MEMO ONE 


TD: J.D. SWIFT. 
SALES DEPARTMENT 


|IAMIMPRESSED WITH YOUR 
STEADY INCREASE IN SALES. 


Stored Page Segment LET’SGET TOGETHER AND 


DISCUSS SOME STRATEGY. 


d CALL MY SECRETARY FOR 
L 5 ANAPPOINTMENT. 


| Hed Lone 


MEM O TWO 


FROM: And Sous 


To: AllEmployees 


Beginning this Friday 
our work week will end 
at3 p.m. Enjoy this 
extra leisure time. 


Figure 4. Using Page Segments 


Using Bar Codes 


Bar code data is encoded information that is recognized by optical scanning 
devices. The AFP Utilities for iSeries can print various types of bar codes in any 
size and with variations, such as with or without the human readable 
interpretation (HRI) characters. 


Using Graphics 
The AFP Utilities for iSeries can include the Graphics Data File (GDF). GDF can be 


created_by OS/400* graphics or created by GDDM* on the System/390*. See 
Appendix 9} for more information. 
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Overlay Utility 


The Overlay Utility enables you to create overlays (electronic forms). Once created, 
an overlay can be placed on pages of output using iSeries printer file support, Data 
Description Specifications (DDS) in conjunction with High-Level Language (HLL) 
application programs, Advanced Print Utility, iSeries page and form definitions, 
AFP Toolbox, Print Format Utility, and other AFP document enabling applications. 
Figure 3 shows how an overlay can be merged with data. 


You can: 
* Design an overlay interactively on a display screen. 


An overlay can contain text with several kinds of fonts, lines, boxes, images, bar 
codes, and graphics. 


* Store the source data of the overlay (source overlay) that you designed in your 
file. 


* Change the source overlay that was previously stored in the file. 
* Create an overlay object from the source overlay. 
* Print the overlay object that was created in the specified library. 


Figure 5 shows a sample overlay. 


AS/400 Stationery Co., Ltd. < ki Ph 


Standard Stationery Sales Slip Date: a 
Item Quantity Unit Amount ($) 
Price 
Ball Point Pen 
Pencil 
Eraser 
Ruler 
Total 
Revenue Last Five Years 

e — 
s 4 (2 Eraser 
= | @ Pencil 229° 
= Hn P a Poke Pon Form No. 5A-3323-01 


Sales by Year ll 


Figure 5. Sample Overlay (Created by the Overlay Utility) 
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Print Format Utility 


The Print Format Utility provides the capability to develop AFP output 
applications directly from database files. With the Print Format Utility, you can: 
* Design your desired layout of a record interactively in the same way as the 
Overlay Utility. 
You can define headings, boxes, or logos which contain text, lines, boxes, 
images, bar codes, and graphics to be printed in addition to the data in the 
database file member. 


Figure 6 shows a sample label you can create from a record in a database file 
using the Print Format Utility. 


Product : Color TV 


Price > 98 


0 
WUT < ae 


Figure 6. Sample Label (Created by the Print Format Utility) 


* Design a page layout interactively in the same way as in the Overlay Utility. 


You can define headings, boxes, or logos which contain text, lines, boxes, 
images, bar codes, and graphics to be printed. 


* Save the record layout and page layout as a printout format definition in your 
file. 


* Print a database file member according to the printout format definition. 


* Replicate a record layout across and down the page such as in a multiple-up 
label application. 
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Figure 7 shows a print sample of the labels you can create using the Print Format 


Utility. 


Product :Color TV 


Price 


AMUN 


Product : AM Radio 


Price 


“WML I 


“PMI 20 


Product : FM Radio Product : Video 
Price Price 

“WAU Tite A 
Product :Video2 Product :CD player 
Price Price 


“WIMIUNI 3 


Product :Ball point pen 


Price 


WHI UI a 


Product : Pencil 


Price 


“WIA MN 


Figure 7. Print Sample (Labels) 


You can create various kinds of output from one database file member. For 
example, you can print a list of products, product descriptions, or even delivery 


labels as shown below from one database file member by using different printout 


format definitions. 
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* 
eee peewee ee eee ee ee ee ee ee * 

V V V 
*¥¥e------- * Kee * Kee ------ * 
Print Print Print 
Operation Operation Operation 
*e----- *ke---- * *e---- *----- * *Ke---- *¥e---- * 


<-*PFD definition 1 <-*PFD definition 2 <-*PFD definition 3 


Output 1 Output 2 | Output 3 | 
V V V 
Kee * Kee * Kee ee * 
List of products Product descriptions Delivery labels 
eee ----- Keo * *ke--------- * kee * 
|Product Name|Price| Product name: Color TV AM Radio 
Goose maces eee tl|| ||) Geeta 300 20 
|| Color Tv | 300] | | Color TV i ea a 
Aw Radio | 20] | | ---------2------ LOTTE HATE 
Video 500 Price : $300. Renee ccnan- keene non-H * 
: : Country : U.S.A. kann ------- * kann ------- * 
Stock : XXXXx | Video | |CD Player | 
| | : : | | 500 | | 100 | | 
| | oo 2s + | 
a tenet | | | 
Kee * Kee eee * Kee ee * 


Resource Management Utility 


The images used by the Overlay Utility and the Print Format Utility (or any AFP 
application) are stored as page segments. These images are normally scanned into 
a client workstation. The Resource Management Utility is an interactive tool to: 


* Convert an image to page segment. 

* Convert a page segment to a physical file. 

* Convert an overlay object to a physical file. 

* Resize and rotate images as they are being created. 


It also maintains AFP resource objects, such as page segments or overlay objects. 


You can: 
* Create a page segment from a physical file member. 
* Create a page segment from a PC document. 


* Convert a page segment or an overlay to a physical file member. (You can then 
transfer these AFP resource objects to other systems such as the System/370.) 


* Copy, delete, rename, and print an overlay object, or display and change the 
description of an overlay object. 


* Copy, delete, rename, and print a page segment, or display and change the 
description of an page segment. 
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AFP Resource and AFP Utilities for iSeries 


There are five kinds of AFP resources. The following table describes the 
relationship between AFP resources and AFP Utilities for iSeries. 


Table 1. Relationship between AFP resources and AFP Utilities for iSeries 
AFP Resource iSeries Object Type Relationship to AFP Utilities 


Overlay *OVL Create, change’, copy, delete, print, rename, 
display and change description, and convert to a 
physical file. 


Page segment *PAGESEG Create”, copy, delete, print, rename, display and 
change description, and convert to a physical 
file. 

Form definition *FORMDF A form definition? name or special value 


*INLINE can be specified for printing database 
file members. 

Page definition *PGDFN No relation. 

Font *FNTRSC Font resources, both iSeries—resident and 
printer-resident, are used to print text within the 
Overlay Utility and the Print Format Utility. 


Note: 
1 means that an AFP Utilities for iSeries source overlay is used. 
? means that a physical file or a PC document is used. 


’The Form definition option can be specified when printing a database file member or 
when defining printout specifications for PFD definitions. 


Requirements for Use of the AFP Utilities for iSeries 


To use the AFP Utilities for iSeries, the following hardware and software products 
are required. 


Hardware Requirements 
* Any model of iSeries. 


* Any model of a 5250 display terminal or 5250 emulated work station that 
supports an 80 x 24 display size. 


For DBCS support, a DBCS display workstation is required. 
* One of the following IPDS printers is required: 


— 4224, 4230, 4234-12, 4230-102, 4247, 6400, 6404, 6408, 3130, 3160, 3812, 3816, 
3930, 3112, 3116, 4312, 4317, 3912, 3916, 1931, 3935, and 4028 with the Arctic 
attachment 


— 3820 with SNA LU6.2 (SDLC attachment) 


— 3820, 3825, 3827, 3829, 3831, 3835, and 3900 with the SNA LU6.2 (Token Ring 
attachment through Remote Print Manager on Personal Computer AT* or 
Personal System/2*) 


Software Requirements 
* OS/400 Version 4 Release 2.0. 


* Print Services Facility for iSeries, Version 4 Release 2.0 (5769-SS1), for printing to 
IPDS printers. Overlays and AFP applications created by AFP/U can also be 
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printed on HP-CL printers if transformed first by the Host Printer Transform, 
which is an integrated print subsystem of iSeries. 

* Support for accessing image files on a client workstation through a program 
such as iSeries Access. 

* iSeries—resident AFP fonts as required by overlays and Print Format Utility 
applications. Fonts are available in 240 dot per inch (dpi), 300 dpi, and outline 
fonts with AFP Font Collection (5468-113), in both SBCS (single byte character 
set) and DBCS (double byte character set) versions. 


AFP Utilities Fundamentals (Concepts) 


This section describes the concepts and terminology used in AFP Utilities for 
iSeries. 


Libraries, Files, and Members 


Information or data is organized and stored on your system in various forms. 
When you work with AFP Utilities for iSeries, you need to understand the 
relationship between libraries, files, and members on the system. A library is a 
place on the system to store files and objects. A file contains one or more members. 
When a file is copied to another file, all the members that are contained in the 
original file are copied to the new file also. When a file is erased, all the members 
that are contained in the original file are erased also. 


Figure 8 shows the relationship of the members and the files in the library. 


Library 


Members 


Members 


Figure 8. Members and Files in a Library 


When you create a member such as a source overlay or a printout format 
definition (PFD definition), you need to create a library and a file (a source overlay 
file or a PFD definition file) in advance to store the member. 


Elements 


The elements are text, lines, boxes, bar codes, page segments, and graphics that are 
defined in a source overlay and a printout format definition. In a page layout of a 
printout format definition, you can define a record as an element. 


a a ag A for more information about 
defining elements in a source overlay and a printout format definition. 


AFP Utilities for iSeries Displays 


Several types of displays are shown when you use the AFP Utilities for iSeries. 
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Menu Display 

When you start AFP Utilities for iSeries by entering the STRAFPU command, the 
menu for IBM Advanced Function Printing Utilities for iSeries is shown. You can 
start any function of AFP Utilities for iSeries from this menu. 


Figure 9. Menu for the IBM Advanced Function Printing Utilities for iSeries 


( AFPU IBM Advanced Function Printing Utilities for iSeries \ 


Select one of the following: 


Overlay Utility 
1. Work with source overlays 
2. Work with source overlay files 


Print Format Utility 
11. Work with PFD definitions 
12. Work with PFD definition files 
13. Print database file member 
14. Print AFP Utilities tutorial 


Resource Management Utility 
21. Convert to page segment 
22. Work with overlays 
23. Work with page segments 


Selection or command 
===> 


F3=Exit F4=Prompt F9=Retrieve F12=Cancel F16=System main menu 
(C) COPYRIGHT IBM CORP. 1991, 1996. 


Work with Display 
To indicate fields on the Work with display, two different words are used in this 
manual. They are prompts and columns. 


Prompts: A prompt is a request for information on a display that allows you to 
type a response. For example, the File, Library, Source overlay, and Position to fields 
are prompts on the Work with Source Overlays display. 


When F4 for list is shown to the right of the prompt, you can show a list by 
placing the cursor in the field and pressing the F4 key. 


Columns: A column is either a request for information or lines of information that 


define certain fields in a list. For example, the Opt, Source Overlay, Text, and 
Changed fields are columns on the Work with Source Overlays display. 
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/— Work with Source Overlays a 


FIG ian dirk ancien OVLFILE Name, F4 for list 
LIBARY seid dese eoaen. ane OVLLIB Name, *LIBL,*CURLIB 
Prompts Source overlay......... *ALL Name, generic*, *ALL 
Position fo. ......... Starting characters 


Type options, Press Enter. 
1=Create 2=Change 3=Copy 4=Delete 6=Print 9=Create overlay 


Source 
Opt Overlay Text Changed 
1 STATIONARY 
\ Z 


Columns 


Bottom 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F11=Display names only 


2=Cancel J) 


Figure 10. Prompts and Columns on the Work with Source Overlays Display 


Design display 
The following Design displays are available: 


* Design Overlay display 
* Design Record Layout display 
* Design Page Layout display 


The Design display has two views. One is the screen view and the other is the list 
view. You can switch the view from one to the other by pressing the F17 key. 


+------------------- + F17 +----------------- + 


Screen View: In the screen view, an approximate print image is displayed in the 
upper part of the screen called the image area. You can design an overlay, a record 
layout, and a page layout while viewing the approximate print image being 
created on the display. When you enter the Design display, the display is initially 
set to the screen view. 


16 AFP Utilities for iSeries: User’s Guide 


In the screen view, the display is divided into the image area and the key entry 
area when you define or change an element as follows: 


Figure 11. Design Display 


Design Overlay Columns: 1- 74 
Source overlay . .. . . STATIONERY 
eS ee ee ee ee. ee ee - ee ae 


T7001 


Image 
area 


More... 
Define Text 
: *TO01 Measurement method . . . . : Row/Column Key 
Position... .. Across __32 Down _ 2 entry 
Text Data. .... area 


F3=Exit F4=Detail F6=Change measurement method 
Fl2=Cancel F24=More keys 


9| for more information. 


List view: In the list view, all element definitions are listed on the display in the 
order of the sequence number unless the list has been sorted using F4=Sort. The 
list can be sorted by the sequence number (NBR), name, or across or down 
position. Each line describes one element. The intended use of the list view is to 
view elements that are already designed and to make changes to the elements. 
However, list view can also be used to define, copy, move, or remove elements. 
You may easily find an element because you can see part of the definitions such as 
the bar code data and the page segment name that are not displayed on the image 
area in the screen view. You can switch to the screen view by pressing F17. See 

for more information. 


Function Keys 


You can use the available function keys on each display in AFP Utilities for iSeries 
to perform specific tasks. For example, if you press F12, the display changes to the 
one you worked on before the current display appeared. 


Note: The functions available for your use are shown at the bottom of the display. 
If both lines show function keys, there may be additional ones that are not 
shown. To see a complete list of function keys supported on a display, press 
F24 to show the remaining keys, or position the cursor in the function key 
area of the display and press the Help key. 


On the Design display, some function keys work differently depending on the 
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Table 2. Summary of AFP Utilities Function Keys 


Work Station Key 


Key Name 


Description 


F1 or Help 
F3 


P4 


F5 


F6 


Fl 


F12 


F24 

Enter 

Roll Up (Page Down) 
Roll Down (Page Up) 
Print 


Sys Req 


Help 
Exit 


For list or Prompt 


Refresh 


Change 
measurement 
method 


Alternate view 


Cancel 


More keys 
Enter 


Roll Up (Page 
Down) 

Roll Down (Page 
Up) 

Print 


System Request 


Shows additional information about a field, 
display, or message. 

Ends the current task and returns to the display 
where you started. 

Shows a list of items you can select if the cursor 
is on a field that supports F4 for list. 


You can type a command on the command line 
and press F4 to show the prompt display of the 
command. On the command prompt display, 
you can press the F4 key to see a list of possible 
entries for the field where the cursor is 
positioned. 

Restore the input fields of the display to their 
original values. If there is a list of information 
on the display, the list is updated to reflect the 
latest information of the system. 

Change the measurement method used to 
specify the position and other fields, such as 
width and height, between row/column and 
inch/ centimeter. 

If there is a list of information on the display 
and the list has another format, the list is 
changed to the other format. For example, on 
the Work with Source Overlays display, by 
pressing F11, the Text disappears and additional 
source overlay names are shown on the display. 
Quits the current display. Any information 
entered is ignored. The previous display 
appears. 

Shows the next set of function keys available for 
the display. 

Submits information on the display for 
processing. 

Moves forward to show additional information 
for this display or another message. 

Moves backward to show additional information 
for this display or another message. 

Prints information currently shown on this 
display. 

Interrupts the job you are currently working on 
and shows a menu from which you can do 
various tasks. 
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Related Online Information 


The following online information is available on the iSeries system. After pressing 
the Help key on any menu, press the Help key a second time to see an explanation 
of how the online information works, including the InfoSeeker function. You can 
press either the Help key or F1 for help. 


Help for Displays 
You can press the Help key on any display to see information about the display. 
Two types of help are available: 


Contextual 


Extended 


Contextual help explains the field on which the cursor is positioned when you press 
the Help key. For example, it describes the choices available for a prompt. If a 
system message appears at the bottom of the display, position the cursor on the 
message and press the Help key to see information about the cause of the message 
and the appropriate action to take. 


Extended help explains the purpose of the display. Extended help appears if you 
press the Help key when the cursor is outside the areas for which contextual help 
is available, or if you press F2 (Extended help) when you are looking at the 
contextual help. 


To exit the online information, press F3 (Exit). You return to the display where you 
pressed the Help key. 


InfoSeeker 


InfoSeeker is the iSeries implementation of the IBM BookManager Read 
architecture; InfoSeeker provides access to online books from any workstation. It 
provides powerful search and retrieval functions and allows the grouping of 
information to meet individual installation needs. InfoSeeker can read any book 
created by the IBM BookManager BUILD license programs (available for VM, 
MVS, and OS/2 systems). 


To use InfoSeeker, press the Help key, then press F11 (InfoSeeker). You can also use 
InfoSeeker by selecting option 20 (InfoSeeker) on the GO INFO menu. 


Help for Control Language Commands 


To see prompts for parameters for a control language command, type the 
command, then press F4 (Prompt) instead of the Enter key. To see extended help 
for the command, type the command and press the Help key. You can see 
contextual help for CL commands also. 
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Part 2. Overlay Utility 


Chapter 2. Introduction to the Overlay Utility . 
Print Form and Overlay . a 
Source Overlay . : 

Overlay Specifications . 

Overlay Fonts 

Design Overlay . 
Operation Flow . 


Chapter 3. Getting Started with the Overlay ae 
Step 1 - Starting the Overlay Utility 
Step 2 - Creating a Source Overlay File . 
Step 3 - Creating a Source Overlay 
Defining a Text Element . 
Defining a Line Element . 
Defining a Box Element 
Defining a Bar Code Element 
Placing a Graphics Element . 


Viewing the Overlay with the AFP Wotkhendh sive : 


Saving the Source Overlay : 
Step 4 - Changing a Source Overlay . 

Placing a Page Segment 

Creating an Overlay from a eure Overlay 
Step 5 - Using an Overlay 

Overriding a Printer File . 

Using the Printer File . 

Printing Overlays with AFP Utilities fot iSariés 


Chapter 4. Starting and Ending the Overlay es 
Starting the Overlay Utility . ‘ 

Option 1 (Work with source overlays) 

Option 2 (Work with source overlay files) 
Ending the Overlay Utility 


Chapter 5. Work with Source Overlays 
Prompts Pe a re 
Options. 
Columns : 
Showing a Source Overlay iit: 
Selecting a Source Overlay from a List 
1=Create a Source Overlay 
Define Overlay Specifications 
Change Overlay Specifications . 
Confirm Delete of Elements . 
Work with Source Overlay Fonts 
Design Overlay . . 
Saving a Source Overlay . 
2=Change a Source Overlay . 
3=Copy a Source Overlay. 
4=Delete a Source Overlay 
6=Print a Source Overlay . 
7=Rename a Source Overlay . 
9=Create Overlay 


Chapter 6. Work with Source Overlay Files . 
Prompts bok ER A ce, Br a 


. 23 
. 23 
. 24 
. 24 
. 24 
+20 
. 26 


. 29 
. 30 
. 31 
. 33 
. 35 
. 38 
. 39 
. 42 
. 43 
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. 46 
. 49 
. 49 
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. 56 
. 56 
. 56 
ys 


. 59 
. 59 
. 60 
. 60 
. 60 


. 61 
. 62 
. 63 
. 64 
. 64 
. 64 
. 65 
. 66 
. 70 
. 72 
. 73 
. 73 
1 
. 76 
. 77 
. 79 
. 80 
. 80 
. 80 


. 83 
. 85 
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Options. 

Columns 

Showing a ee Overlay File iat 
Selecting a Source Overlay File from a List . 
1=Create Source Overlay File : 
2=Change Source Overlay File Description : 
3=Copy Source Overlay File . 

4=Delete Source Overlay File 

7=Rename Source Overlay File . 


8=Display Description of Source Overlay File : 


12=Work with Source Overlays . 
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. 86 
. 87 
. 88 
. 88 
. 89 
tee 
. 92 
. 93 
. 94 
. 94 
. 94 


Chapter 2. Introduction to the Overlay Utility 


The Overlay Utility is one of the AFP Utilities that allows you to create electronic 
form overlays, which can always be printed in their stored format and can be 
positioned anywhere on the page. 


Using the overlay utility, you can: 
1. Design an overlay interactively on a display. 

The information you defined for an overlay is called a source overlay. 
2. Save a source overlay in your file. 


3. Create an overlay object from a source overlay, which can be printed on the 
IPDS printers. 


You can change the design of the overlay by changing the source overlay. 


Notes: 


1. You cannot directly change the overlay object. You need to change the source 
overlay and create the overlay object from it. 


2. You can work with the overlay object using the resource management utility. 


See hapte 
information. 


Print Form and Overlay 


You can merge the overlay object with various spooled files as your final printout. 
You can use overlays at any time you want on various types of forms. Thus, you 
can eliminate the use of preprinted paper forms. 


The overlay can be composed of text, images, graphics, lines, boxes, and bar codes 
called elements. All of the environmental data (such as font references) is defined 
as a part of the overlay definition. The fonts defined for the overlay are not 
influenced by the fonts used for the variable data on the logical page. 


The basic function of the overlay is to provide a template-like pattern that 
establishes fixed data for merging with various spooled files. 


For each element, you must specify its position and the horizontal and vertical 
distances from the overlay origin. You can also specify the offset, and horizontal 
and vertical distances of the overlay origin from the origin of the page. The initial 
values are set to zero offset in both directions, which means the overlay origin will 
coincide with the page origin. This eliminates the need for preprinted paper forms. 
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Figure 12 shows a sample overlay. 


AS/400 Stationery Co., 


Standard Stationery Sales Slip 


Item 


Quantity 


Unit 
Price 


Date: / 


Amount 


Ltd. ki Pie 


Ball Point Pen 


Pencil 


Eraser 


Ruler 


Total 


Million $ 
! 


Revenue Last 


annE 


Five Years 


© Ruler 
( Eraser 
@ Pencil 
(2) Ball Point Pen 


Sales by Year 


Figure 12. Sample Overlay 


Form No. 5A-3323-01 


TT 


Source Overlay 


A source overlay provides the necessary information to create an overlay object 


that can be printed on an IPDS printer. 


The following information must be provided in a source overlay. 


Overlay Specifications 


The specifications contain characters per inch, lines per inch, degree of rotation, 


default element measurement method, and so on. 


Overlay Fonts 


Fonts are predefined, but can be changed. 
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Design Overlay 


An overlay image can be designed in a source overlay. The following elements can 
be placed or defined in a source overlay. 


Text 


Line 


Box 


Bar Code 


Page Segment 


Graphic 


Text, such as ABCDE , specified in an overlay is called a text element. It can be 
placed at any specified position on the overlay. The text attributes may also 
be specified to describe the text characteristics such as font selection, vertical 
and horizontal format, character size, overstrike, and color. 

The line element is any straight line that connects two points either 
vertically or horizontally. You may select the type of line, such as dotted, 
dashed, or solid, and the line width. 

The box element is a rectangle that is defined by the two diagonally 
opposite corners. It can be placed anywhere on the overlay. You can select 
the shade pattern inside the box, the type of box line (either dotted, dashed, 
or solid), and line width. You may define text inside the box. Optionally, the 
text may be justified inside the box. 

The bar code element is a set of bars and spaces of various width created 
from data by IPDS printers or It can be placed at a specified position on the 
overlay. You can specify the following: 


* Bar code data 

¢ Placement position 

° Type of bar code 

* Size 

* Color 

¢ Whether or not to print a human-readable interpretation (HRI) 


* Whether or not to include a check digit 

A page segment is an image in the AFP resource library. You can refer to a 
page segment by its name and specify the print position to define it as an 
overlay element. You can include the same page segment repeatedly in an 
overlay. 

A graphic is an image constructed by vector data. Graphics can be created 
by using iSeries GDDM (Graphical Data Display Manager) or Business 
Graphics Utility. A graphic is stored on iSeries as a graphic data file. or 
iSeries GDDM and stored in an iSeries file. You can refer to a graphic by its 
file and library name and specify an area that is defined by the two 
diagonally opposite corners to define it as an overlay element. See 

on how to create 


GDF files. 


You can select any of the overlay elements above and place them at the desired 
positions to define the overlay. 
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Operation Flow 


Figure 13 shows an overview of the overlay utility operation and how to create an 


overlay. 


Step 1 


Step 2 


Step 3 


Step 4 


Kee ---- * 
| Define overlay | 
specifications 
and fonts 
*e------ Kee * 
Kee -- | wee ee * 
fees > | 
V 
Ke------ * 


| Place Element on | 


| a Source Overlay | 
V 
Kee ---- * 
| | Define Contents | 
| of Element | 
Ke------ Kee * 
eee ee * 
Kee -- +----------- * 
V 
Ke--------- -- - * 
| Save a Source 
| Overlay 
K¥e------ *¥e------ * 
V 
Ke------ - -- * 
Create 
an Overlay 
Kee ----- * 


Figure 13. Overview of Overlay Utility Operation 


Step 1. 


Step 2. 


This is an optional step. 


You can change the default values of the overlay specifications. These 
include printer type, characters per inch (CPI), lines per inch (LPI), degree 
of rotation, unit of measure, default data elements measurement method, 
overlay size, offset, and_a grid to help design the overlay. See 

ge 64 for more information. 


You can oe the fonts used to print text. See Chapter 14. Work withl 


for more information. 


Design your overlay. 

Repeat the following operations: 

a. Position the cursor on the screen where you want to enter an element, 
such as text, box, and so on. 

b. Place an element in the overlay by pressing the function key assigned 
for the element. 


c. Type the element specification. After entering the data, a mark is 
assigned for the element by the overlay utility. The mark is placed at 
the element position on the screen. 


Zifor more information. 
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Step 3. After designing the overlay, save it as a source overlay in your library. The 


Step 4. Create an overlay object from this source overlay and save it in the AFP 


overlay utility prompts you to specify the source overlay and library name 
in_which to save the source overlay. See 
for more information. 


resource library. See 


The following chapters show you how to: 


* Get started with the Overlay Utility and use it practically by performing an 
exercise 


* Start and end the overlay utility 


* Work with a source overlay 


Create a source overlay 

- Define overlay specifications 

- Work with source overlay fonts 
- Design overlay 

Change a source overlay 

Copy a source overlay 

Delete a source overlay 

Rename a source overlay 

Print a source overlay 

Create an overlay 


* Work with a source overlay file 


Create a source overlay file 

Change a source overlay file description 
Copy a source overlay file 

Delete a source overlay file 

Rename a source overlay file 


Display a source overlay file description 


While using IBM Advanced Function Printing Utilities for iSeries, you can press 
the F1 key to display help information. 
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Chapter 3. Getting Started with the Overlay Utility 


This chapter describes how to create an overlay with the Overlay Utility by 
showing a practical exercise. 


The operational steps of creating an overlay with the Overlay Utility are as follows: 


Step 1. 
Step 2. 
Step 3. 


Step 4. 


Step 5. 
Notes: 


Starting the Overlay Utility. 

Creating a source overlay file in a library. 

Creating a source overlay in the previously created source overlay file. 
This step consists of the following sub-steps: 

a. Designing a source overlay 


1) Defining a text element 


a) 


Defining a line element 


ee) 


Defining a box element 


) 
) 
) 
) 


a 


Defining a bar code element 
5) Placing a graphics element 
b. Viewing the overlay with the AFP Workbench Viewer 
c. Saving the source overlay 
Changing a source overlay. 
This step consists of the following sub-steps: 
a. Designing a source overlay, including placing a page segment 
b. Saving the source overlay 
c. Creating an overlay from a source overlay 
Using an overlay. 


1. Some printers do not support bar code and graphics architectures. If your 
printer does not support graphics, you should not place graphics in a source 
overlay. If your printer does not support bar codes, you should specify your 
printer type on the Define Overlay Specifications display in the "Creating a 
Source Overlay” step. AFP Utilities for iSeries generates appropriate data to 
print a bar code on those printers. See IBM Printing Systems: Printer Information, 
(S544—5750), to check if your printer supports them. 


2. To perform the following task, you need a page segment and a physical file. 
Page segment QFCLOGO and physical file QAFCGRPH should exist in library 
QGPL. If they do not exist, copy page segment QFCPAGS and physical file 
QAFCGDF from library QAFP to library QGPL as page segment QFCLOGO 
and physical file QAFCGRPH. You can use the Create Duplicate Object 
(CRTDUPOBJ) command to accomplish this. 
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Step 1 - Starting the Overlay Utility 


Example Actions: 
1. Type STRAFPU on the command line. 
2. Press the Enter key. 


The IBM Advanced Function Printing Utilities for iSeries menu appears. 


(“ arpu IBM Advanced Function Printing Utilities for iSeries >) 
Select one of the following: 


Overlay Utility 
1. Work with source overlays 
2. Work with source overlay files 


Print Format Utility 
11. Work with PFD definitions 
12. Work with PFD definition files 
13. Print database file member 
14. Print AFP Utilities tutorial 


Resource Management Utility 
21. Convert to page segment 
22. Work with overlays 
23. Work with page segments 


Selection or command 
===>57 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F1l6=System main menu 
(C) COPYRIGHT IBM CORP. 1991, 1996 


From this display, you can select any function of AFP Utilities for iSeries. 


The overlay utility functions are: 


Option Function 
1 Work with source overlays 
2 Work with source overlay files 


Before you create a source overlay, you must create a source overlay file to store it. 
Note: You need a library to create a source overlay. OVLLIB is used in the 
following example, but you may use the name of your library instead. If 


you do not have any libraries, create a library by typing CRTLIB OVLLIB on 
the command line and pressing the Enter key. 
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Step 2 - Creating a Source Overlay File 


Example Actions: 
1. Type 2 on the command line. 
2. Press the Enter key. 


The Work with Source Overlay Files display appears. 
r >) 


Work with Source Overlay Files 


Type choices, press the Enter key. 


DV ARYS a ceescase eee heen ce Wee OVLLIB Name, *USRLIBL, *LIBL 
*CURLIB, *ALLUSR, *ALL 
Faiuli@' se. re, cee terse cere eee tay secs *ALL Name, generic*, *ALL 


Parameters or command 
===> 


F3=Exit F4=Prompt F5=Refresh F9=Retrieve  F12=Cancel 
Ne 


Example Action: Type OVLLIB in the Library prompt and press the Enter key to list 
source overlay files stored in OVLLIB. 


Ga - 


Work with Source Overlay Files 


IENID RAY cee teressiise ben en ses OVLLIB Name, *USRLIBL, *LIBL, *CURLIB... 
[mall] W='s @targureeaprsale sae sence ternary’ *ALL Name, generic*, *ALL 
Position: toi. <3 & 4s Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 7=Rename 
8=Display description 12=Work with source overlays 


Opt File Library Text Changed 
1 OVLFILE OVLLIB 


(No source overlay files in library) 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 
F12=Cancel 


ees 


Note: No source overlay file is shown because no source overlay file is stored in 
OVLLIB. 
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Example Actions: 

1. Type 1 (Create) in the Opt column on the first line of the list. 
2. Type OVLFILE in the File column on the first line of the list. 
3. Type OVLLIB in the Library column on the first line of the list. 
4. Press the Enter key. 


The Create Source Overlay File display appears. 
ee * 


Create Source Overlay File 


Fidei cts) 2G eee ees OOVERTEE 
Idibrary Ap eisai es OVLLIB 


Type choices, press Enter. 


User specified DBCS data... WN Y=Yes, N=No 
Text. "description. c6. 45 Source overlay file for exercise 
Authority vec ses. oad es *LIBCRTAUT Name, *LIBCRTAUT, *ALL 


*CHANGE, *EXCLUDE, *USE 


F3=Exit F5=Refresh  F12=Cancel 


XS 4 


From this display you can specify: 


* Whether or not you use DBCS data (this prompt is only displayed on DBCS 
systems). 


* A short description of the source overlay file up to 50 SBCS characters long. This 
description is saved with the source overlay file and displayed when the source 
overlay files are listed to help you to identify the source overlay files. 


* Authority given to users who do not have specific authority to the source 
overlay file. 


Example Actions: 
1. Do not change the default value for the User specified DBCS data prompt. 


Note: This prompt field appears only when your system is DBCS capable. 
2. Type Source overlay file for exercise for the Text ‘description’ prompt. 
3. Press the Enter key. 


The Work with Source Overlays display appears. 
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Step 3 - Creating a Source Overlay 


In this step, an overlay is designed by creating a source overlay. 


Ke 


Work with Source Overlays 


Falil@ccurcesa peut xsance ces tem OVLFILE Name, F4 for list 
LEaIDRaRY ssc. ee tones es ve OVLLIB Name, *LIBL, *CURLIB 

Source overlay ..... *ALL Name, generic*, *ALL 

Positaion! to. ces Ss ee Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 6=Print 7=Rename 
9=Create overlay 
Source 


1 STATIONERY 


(No source overlays in file) 


Parameters or command 

===> 

F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1ll=Display names only 
F12=Cancel 


x 


Opt Overlay Text Changed 


Bottom 


Example Actions: 
1. Type 1 (Create) in the Opt column in the first line of the list. 


2. Type STATIONERY in the Source Overlay column in the first line of the list. 


3. Press the Enter key. 


Note: Unless it is changed, the first 8 characters of the source overlay name will be 
used for the overlay (object) name when you create an overlay (object) using 


option 9 (Create overlay). Any remaining characters are discarded. 


The Create Source Overlay display appears. 


fe Create Source Overlay . 
alti Ho ayets ees ae Coe arr ete remeron) qe pal Le 
[eaibrediteye” sce cea esas teteer tema cons OVLLIB 
Source overlay ..... .. : STATIONERY 
Type options, press Enter. 
1=Select 
Opt Action 
Define overlay specifications 
Work with source overlay fonts 
1 Design overlay 
F3=Exit F5=Refresh F9=Select all F12=Cancel 
Ne y 
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Example Action: 


1. Press the Enter key. 


The Design Overlay display appears. 


In this example, source overlay STATIONERY in OVLFILE is being used to design 


an overlay. 


AS/400 Stationery Co., Ltd. ki Ph 
Standard Stationery Sales Slip Date: ae 
Item Quantity Unit Amount (S$) 
Price 
Ball Point Pen 
Pencil 
Eraser 
Ruler 
Total 
Revenue Last Five Years 

a © Ruler 
s 4 C Eraser 
= = , 
= 7 | mre Form No. 5A-3323-01 


Sales by Year 


Figure 14. Sample Overlay 
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TT 


Defining a Text Element 


ae 


Co 


00 
00 
00 
00 
00 
00 
00 
00 


ntrol 


Design Overlay Columns: 1- 74 
Source overlay ..... STATIONERY 


Hereh cts thleraneres WeustecnePustouaite Orcueteus fronetsta Dielsvacort stetae Gravavoistt ovelece anys clectin accel Oisunrsbsttlenecereth scayece 


1 
2 
3 
4 
5 
6 
7 
8 


1=Bar code 


More... 
F6=Text F9=Line F10=Box 
F21=Element edit F22=Block edit F24=More keys 
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Example Actions: 


1. Move the cursor to the position (Across : 32, Down : 2) where you want to 


place the text. 
2. Press the F6 key. 


area appears on the lower part of the display. 


Mark %T001 to indicate a text element appears in the image area and the key entry 


ff 


Design Overlay 


Control Source overlay 


001 
002 %T001 
003 
004 
005 
006 
007 
008 
009 
010 
011 
012 


Define Text 

Measurement me 
Across 32 Down 
. iSeries Stationery Co., Ltd. 


Matekeeeescreere et mene: 
Position 
Text data 


F3=Exit 
F12=Cancel 


F4=Detail 
F24=More keys 


F6=Change measureme 


‘ 


Columns: 
STATIONERY 


thod 
Z. 


nt method 


1- 74 


: Row/Column 


a 


Example Actions: 


1. Type iSeries Stationery Co., Ltd. in the Text data prompt. 


2. Press the Enter key. 


The following display appears. 


ia 


Design Overlay 


Control Source overlay 


*T001 Statio 


More... 
F6=Text 
F21=Element edit 


F3=Exit 
Fll=Bar code 


F9=Line 
F22=Block edit 


Columns: 


nery Co., Ltd. 


F10=Box 
F24=More keys 


1- 74 
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Example Actions: Define another text element. 


1. 
2. 
3. 


4. 


Move the cursor to position (Across : 10, Down : 4). 
Press the F6 key. 


Type Standard Stationery Sales Slip Date: / / on the Text data 
prompt in the key entry area. 


Press the Enter key. 


The following display appears. 


ee 


Design Overlay Columns: 1- 74 
Control. . Source overlay ..... STATIONERY 
Aesecite evarel une tegerere Done fare herencde Susie ese ct ctencasie: atcrercet meqahaio ehexcreck wostrelOlete coc sLnaereen a cnees 

001 

002 *T0Q01 Stationery Co., Ltd. 

003 

004 *T002 rd Stationery Sales Slip Date: ff 

005 


016 
017 
More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


SS ee 
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Defining a Line Element 
Example Actions: 
1. Move the cursor to position (Across : 10, Down : 5) to start defining a line. 
2. Press the F9 key. 


The following display appears. 
( Design Overlay Columns: 1- 74 >) 

Control «= Source overlay ..... STATIONERY 

cue wectiaras creel roti ch wy cporc Osa otes cutee) cre ci Oiene sreitissorere Ghisestane tiercacrn OU etctavcak move Ole encyectaene eet) craters 

001 

002 *T001 Stationery Co., Ltd. 

003 

004 *T002 rd Stationery Sales Slip Date: bod 

005 %L003 

006 

007 

008 

009 

010 

011 

012 

013 

014 

015 

016 

017 


More... 
F3=Exit F5=Refresh F9=Line F12=Cancel 
Fl5=Mark on/off F16=Hide F19=Left F2Q=Right 
Specify opposite end of line and press F9. 


So S 


Example Actions: 


1. Move the cursor to position (Across : 39, Down : 5) to define the end of the 
line. 


2. Press the F9 key. 


The key entry area appears on the display. 
( Design Overlay Columns: 1- 74 . 

Control «..% Source overlay ..... STATIONERY 

Wee ats adele cet sau ds suctis ca Oatsnach wes Alaasw teens Diateee tests Ousted access 

001 

002 *T001 Stationery Co., Ltd. 

003 

004 *T002 rd Stationery Sales Slip Date: fod 

005 %LQ03 ------------------------ 

006 

007 

008 

009 

010 

011 

012 


More... 
Define Line 
Mark: @ 2) ea of ALOOS Measurement method . . . . : Row/Column 
Start position . . Across 10 Down 5 
End position . . . Across 39 Down 5 


F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 


____ a _l==_ iii: ea 
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Example Action: Press the Enter key to define the line element in the source 


overlay. 


The following display appears. 


a 


Design Overlay 


005 #003 222-2 enwesuctelceteties 


A 


004 *T002 rd Stationery Sales Slip Date: 


Columns: 1- 74 


Control .. Source overlay ..... STATIONERY 
Hravaoeitate sol searegech sreverei2iavererc tress ssid iarstevest scatare Gh otere: ach craters avestuoreratelOresre Piateciadestatete 


002 *T0Q01 Stationery Co., Ltd. 


lime: 


More... 


F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


defined. 


Defining a Box Element 


Example Action: Move the cursor to position (Across : 5, Down : 7) to start 


defining a box, and press the F10 key. 


The following display appears. 


Mark %L003 changes to *L003 in the display to show that the line is correctly 


ye 


Design Overlay 


001 
003 


005 I ee 
006 

007 %B004 

008 

009 

a 


oooqoo 0 © © 
NOOB WNHeH © 


F3=Exit F5=Refresh  F10=Box F12=Cancel 
Fl5=Mark on/off F16=Hide F19=Left F2Q=Right 
Specify opposite corner of box and press F10. 


004 *T002 rd Stationery Sales Slip Date: 


Columns: 1- 74 


Control .. Source overlay ..... STATIONERY 
He avareitiarer etal Liscarevoch ereraiei2 stereceteteravel Dietesevestesatere ly onsretartiovasese)ie-s-avertiecere’e|Oicretepettare-ciatlg asi 


002 *T001 Stationery Co., Ltd. 


() 


More... 
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Example Actions: 


1. To specify the opposite corner of the box, press the Page Down (Roll Up) key 
two times. 


2. Move the cursor to position (Across : 60, Down : 26) to define the opposite 
corner of the box and press the F10 key. 


The key entry area appears on the display. 


a 


Design Overlay Columns: 1- 74 
Control. .s.. Source overlay ..... STATIONERY 
Mista ra Pie aie eile guavectence cone 2 ini gave teavs sue ianevcvart « cyereiA c.ace.etiaveueceDreireve eth ayevsis Dacniesectraserccad ei suare 


017 
018 
019 
020 
021 
022 
023 
024 
025 ‘ A 
026 ta ----- 2-2-2222 -- - o-oo ----- + 
027 
028 
More... 
Define Box 

MaiKetosces ie cus se oo RBOO4 Measurement method . . . . : Row/Column 
Start position . . Across 5 Down 7 

End position . . . Across 60 Down 26 


F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 


‘ 


Example Action: Press the Enter key to define the box element in the source 
overlay. 


The following display appears. 


7 


Design Overlay Columns: 1- 74 
Control «.< Source overlay ..... STATIONERY 
es roceutuatas snes esadaro tes eave Crane asedttarerevs iareicvact cionere Generis tls evcreDistetaie Tespste ss Ocssiniethiase sictdeetaues 
017 ; 
018 
019 
020 
021 
022 
023 
024 
025 : : 
026 ta ---- 22-22-22 2-2-2 o-oo eo ------- + 
027 
028 
029 
030 
031 
032 
033 
More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 
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Example Actions: Define the following elements in the same way: 

1. A line element from (Across : 5, Down : 24) to (Across : 60, Down : 24). 
2) to (Across : 60, Down : 22 
0) to (Across : 60, Down : 20 
8) to (Across : 60, Down : 18 


A line element from (Across : 5, Down : 22) 
20) 
18) 
A line element from (Across : 5, Down : 16) to (Across : 60, Down : 16 
14) 
12) 
10) 


A line element from (Across : 5, Down : 

A line element from (Across : 5, Down : 

A line element from (Across : 5, Down : 14) to (Across : 60, Down : 14 

2) to (Across : 60, Down : 12 

A line element from (Across : 5, Down : 10) to (Across : 60, Down : 10 
9. A text element Ball Point Pen at (Across : 7, Down : 11). 

10. A text element Pencil at (Across : 7, Down : 13). 

11. A text element Eraser at (Across : 7, Down : 15). 

12. A text element Ruler at (Across : 7, Down : 17). 

13. A line element from (Across : 22, Down : 7) to (Across : 22, Down : 24). 

14. A text element Total at (Across : 7, Down : 25). 

15. A line element from (Across : 35, Down : 24) to (Across : 35, Down : 7). 

16. A line element from (Across : 46, Down : 7) to (Across : 46, Down : 24). 

17. A text element Item at (Across : 10, Down : 8). 

18. A text element Quantity at (Across : 24, Down : 8). 

19. A text element Unit at (Across : 37, Down : 8). 

20. A text element Price at (Across : 37, Down : 9). 

21. A text element Amount ( $ ) at (Across : 48, Down : 8). 

22. A line element from (Across : 52, Down : 5) to (Across : 59, Down : 5). 

23. A text element Form No. 5A-3233-01 at (Across : 45, Down : 33). 


A line element from (Across : 5, Down : 


oeNoaPpPwh 


When the above elements are defined, the following display appears. 
( Design Overlay Columns: 1- 74 . 
Control 2 « Source overlay ..... STATIONERY 


025 : *7018 5 
026 tan nnn nnn n-ne ono nooo o-oo eee eee -- + 
027 
028 
029 
030 
031 
032 
033 *T027 0. 5A-3233-01 
034 
035 
036 
037 
038 
039 
040 
041 
More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 
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Defining a Bar Code Element 


Now, define a bar code element below text element *T027. 


Example Action: Move the cursor to position (Across : 43, Down : 34) to define a 
bar code element, and press the F11 key. 


The following display appears. 


F. 


Design Overlay Columns: 1- 74 
Control. a... Source overlay ..... STATIONERY 
Mis cen Pie yarrsse diag mvoctenre cued iat grave ctuevs spe SietaccvartecyonsiAg-acs.ethiaveuereDievreve ath aveveus Oscns ech essreradee suave 
025 : *T018 A 


033 *T027 0. 5A-3233-01 
034 %C028 


More... 
Define Bar Code 
Makes ee seems. oe. teeth *COZ8 Measurement method . . . . : Row/Column 
ROSAEAONIG.: te 5. ay ae Across 43 Down 34 Bar code type... 1 
Bar code data . . 5A-3233-01 
F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 


a 


Example Action: 

1. Type 1 in the Bar code type prompt. 

2. Type 5A-3233-01 in the Bar code data prompt. 

3. Press the Enter key to define the bar code element in the source overlay. 


The following display appears. 


(~ Design Overlay Columns: 1- 74 
Control 5. < Source overlay ..... STATIONERY 
raise cat wyeveratlae suerortis crate’ 2aiara «thers; ere Oiererere tscave el ecctereta vies Wiecerare te ayerere| Ove ws cvedh ere's. aif vhetore 
025 : *T018 : 


033 *T027 0. 5A-3233-01 
034 *C028 


040 
041 
More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 
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Placing a Graphics Element 
Note: If your selected printer does not support graphics, skip this section. 
Now, place a graphics element at the bottom of the overlay. 


Example Actions: 
1. Move the cursor to position (Across : 5, Down : 28) to place a graphics element. 
2. Press the F13 key, then press the F6 key. 


The following display appears. 
e Design Overlay Columns: 1- 74 _ 

Control . . Source overlay ..... STATIONERY 

eae acti teaver epsea bie caveue Queveva sch nackene rave t shin eyetn Gvvataech sueleve ini tcleat ose arti Oiame eto stsyeversihenccies 

025 : *T018 y 

026 tean---------------------------------------------------- + 

027 

028 %G029 

029 

030 

031 

032 

033 *T027 0. 5A-3233-01 

034 *C028 


More... 
F3=Exit F5=Refresh F6=Place graphics  F12=Cancel 
Fl5=Mark on/off F16=Hide F19=Left F20=Right 
Specify opposite corner of graphics block and press F6. 


SS a4 


Example Action: Move the cursor to the right bottom corner of the graphics area 
(Across: 25, Down: 34) and press the PP6 key again. 


The following display appears. 
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Design Overlay Columns: 1- 74 
Control® aes. Source overlay ..... STATIONERY 
Mie feaa Pees ol ecere thee: ow 2 cosneca tiers ves Siecsivce tecens oA are oe Teereees Dieiv enesters ere Ole, avers hase eral viie 


026 ta -- nnn - 22-2 2-2-2 -- + 
027 
028 %GQ29 ------------- + 
029 3: 
030 
031 
032 
More... 
Place Graphics 

Mark: 3:0. & Sse? -*G029 Measurement method . . . . : Row/Column 
Start position . . Across 5 Down 28 

End position . . . Across 25 Down 34 

Source object type . 2 1=PC document, 2=File 


F3=Exit F5=Refresh F6=Change measurement method  F12=Cancel 
F15=Mark on/off Fl6=Hide F19=Left F20=Right 


SS 


Example Actions: 
1. Type 2 in the Source object type prompt. 
2. Press the Enter key. 


The following display appears. 


Design Overlay Columns: 1- 74 
Control «, = Source overlay ..... STATIONERY 


025 : *7T018 A 
026 es + 


027 
028 %@029 -------------- + 
029 ; | 
030 
031 
032 
More... 
Place Graphics 

Mavis serine) cn cress RGOZY Measurement method . . . . : Row/Column 
Start position . . Across 5 Down 28 
End position . . . Across 25 Down 34 
Source object type . 2 1=PC document, 2=File 
Fili@r ies tsGn capt ononrcass QAFCGRPH Name 

Library) gis 3 os QGPL Name, *LIBL, *CURLIB 
MENDES see = aon & *FIRST Name, *FIRST 
F3=Exit F4=Detail F6=Change measurement method 


F12=Cancel F24=More keys 


Example Actions: 

1. Type QAFCGRPH in the File prompt. 
2. Type QGPL in the Library prompt. 
3. Press the Enter key. 


*FIRST in the Member prompt changes to QAFCGDF . 


44 AFP Utilities for iSeries: User’s Guide 


Example Action: Press the Enter key again to place the graphics element in the 
source overlay. 


The following display appears. 

C Design Overlay Columns: 1- 74 ) 
Control .. Source overlay ..... STATIONERY 

Aeevevact crate ctlicvapemach novwarse cyevees her ttctcr Siapetecach oeaara eG asacecnstioycnera Dyer veut orarerslOlevateye tuarere mlacictee 

025 : *7T018 H 
026 tennn------------------- 5-2 --- === ------------------- + 
027 
028 *G@Q029 ----------------- aE 
029 5 ; 

030 

031 

032 : z 

033 c : *T027 0. 5A-3233-01 

034 te--------------------- + *C028 

035 

036 

037 

038 

039 

040 

041 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


\ Ed 


All elements have been defined. 
Viewing the Overlay with the AFP Workbench Viewer 


Note: To use the AFP Workbench Viewer, the workstation must be a 
programmable workstation (PC) and connected to the server system with 
iSeries Access for OS/400 V3R1M3 or later. See the online iSeries Access 
Users Guide for information about connecting iSeries Access to the server. 
The iSeries Access connection must use the same user ID that is used for the 
iSeries session. The iSeries Access Workbench Viewer must also be installed 
on the PC. If your workstation is not a PC or the iSeries Access Workbench 
Viewer is not installed on your system, skip this step. 


Now view what the overlay will look like by using the AFP Workbench Viewer. 


Example Actions: 
1. Press the TAB key to position the cursor to the Control field. 
2. Type «VIEW, and press Enter. 


A display appears showing a simulated printout of a temporary overlay object 
created from your source overlay. When you are finished looking at the simulated 
printout, close the window and proceed. 


Note: Included page segments that are not in a library that is in the system library 
list will not be displayed. Message CWBNP1019, AFP Resource not found, 
will be displayed instead. To view these page segments, do one of the 
following: 


* Add the library name to the system library list (command CHGSYSLIBL). 
* Copy the page segments to library QGPL (command CRTDUPOB)). 
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Saving the Source Overlay 
Example Action: Press the F3 key (Exit). 


The following display appears. 


a Create Source Overlay 
Perc. wines sea ee cs eeeeeeres, = JOVIERTIFE 
albraieys dn gen seve te Scie ees OVLLIB 
Source overlay ....... : STATIONERY 
Type options, press Enter. 
1=Select 
Opt Action 


Define overlay specifications 
Work with source overlay fonts 
Design overlay 


F3=Exit F5=Refresh F9=Select all 


\ 


Example Action: Press the F3 key to exit from this display. 


The following display appears. 


(~ Exit Overlay Utility 
Type choices, press Enter. 
Options ins Gee eee ee we 1 l=Save and exit 
2=Exit without saving 
3=Resume Overlay Utility session 
Return to source overlay list. . y Y=Yes, N=No 
F12=Cancel 


A 
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Example Actions: 


1. Type 1 (Save and exit) in the Option prompt. 


2. Press the Enter key. 


The following display appears. 


a Save Source Overlay ) 
Type choices, press Enter. 
Sourcesoveriiay s:: ssn%s 2: Sass eosasa cess STATIONERY Name, F4 for list 
Fut @reeie. Scum sian te cam uremic eyoar ae arr oan OVLFILE Name, F4 for list 
MERI DSAY ay ete, at ee cee wy ee gp ee Seas OVLLIB Name, *CURLIB 
Text: “description: os gcse) Ses Sample Form number 3 
Delete removed elements ...... N Y=Yes, N=No 
F4=Prompt F5=Refresh  F12=Cancel 
Ne yy 
Example Actions: 
1. Type Sample Form number 3 in the Text ‘description’ prompt. 
2. Press the Enter key. 
The following display appears. 
(~ Create Overlay >) 
Flil@st) co crc eememe cree cs | OVERTIME 
Lqbyary? 6 eee ee ee ee es OVLLIB 
Source overlay ....... : STATIONERY 
TOXt 6 ee we es ee © Sample Form number 3 
Type choices, press Enter. 
Create overlay oc ce aoe os N Y=Yes, N=No 
Overlay os Se ee ew eS STATIONE Name 
[IDMARY- aey eles ee se cer nose cs OVLLIB Name, *CURLIB 
Text ‘description’ ..... Sample Form number 3 
Includeconritd: 2%, 4. eo N Y=Yes, N=No 
Replace: if exists: <4. «4 N Y=Yes, N=No 
Printsoverliayy a. utes0 ce eve be N Y=Yes, N=No 
Authority: 6 esse os es tones *LIBCRTAUT Name, *LIBCRTAUT, *ALL 
*CHANGE, *EXCLUDE, *USE 
F3=Exit F5=Refresh  F12=Cancel 
B/ 
Example Action: Press the Enter key. 
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The following display appears with the completion message. 


‘a ~ 


Work with Source Overlays 


FADO} Somos htt ne usnaey ieleans OVLFILE Name, F4 for list 
IibRany: vee 2o se re eae OVLLIB Name, *LIBL, *CURLIB 

Source overlay ..... *ALL Name, generic*, *ALL 

POSAGION EOL i: 2s ay es Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 6=Print 7=Rename 
9=Create overlay 


Source 

Opt Overlay Text Changed 
STATIONERY 
STATIONERY Sample Form number 3 12/12/90 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve  F1l=Display names only 
F12=Cancel 


LL Source overlay STATIONERY saved in file OVLFILE successfully. S, 


Source overlay STATIONERY has been created in file OVLFILE in library OVLLIB, 
and it is shown in the list. 


Example Action: Press the F3 key to complete the source overlay creation. 


The following display appears. 
ie ie 


Work with Source Overlay Files 


DRA ye ers, ees au esd OVLLIB Name, *USRLIBL, *LIBL, *CURLIB... 
Faeroe as eee oe ee *ALL Name, generic*, *ALL 
POSTiGAON: CO! ie oe sew ede tou ce Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 8=Display description 
12=Work with source overlays 


Opt File Library Text Changed 
OVLFILE OVLLIB 
OVLFILE OVLLIB Source overlay file for exercise 12/12/90 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve  F12=Cancel 
2 Source overlay file OVLFILE created in library OVLLIB. y 


Source overlay file OVLFILE, which contains source overlay STATIONERY, has 
been created in library OVLLIB, and it is shown in the list. 


Example Action: Press the F3 key to exit from this display. 


The IBM Advanced Function Printing Utilities for iSeries menu appears. 
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Step 4 - Changing a Source Overlay 


Placing a Page Segment 


When you want to place a logo image, created as a page segment, on the overlay 
that you have created, perform the following: 


Example Actions: 
1. Type STRAFPU on the command line. 
2. Press the Enter key. 


The IBM Advanced Function Printing Utilities for iSeries menu appears. 
AFPU IBM Advanced Function Printing Utilities for iSeries 
Select one of the following: 


Overlay Utility 
1. Work with source overlays 
2. Work with source overlay files 


Print Format Utility 
11. Work with PFD definitions 
12. Work with PFD definition files 
13. Print database file member 
14. Print AFP Utilities tutorial 


Resource Management Utility 
21. Convert to page segment 
22. Work with overlays 
23. Work with page segments 


Selection or command 


Sse>' ] 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel Fl6=System main menu 
(C) COPYRIGHT IBM CORP. 1991, 1996. 
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Example Actions: 
1. Type 1 on the command line. 
2. Press the Enter key. 


The Work with Source Overlays display appears. 


(~ Work with Source Overlays 
Flt Oneness Petree etal ean OVLFILE Name, F4 for list 
library ~ %: < e OVLLIB Name, *LIBL, *CURLIB 
Source overlay ..... *ALL Name, generic*, *ALL 
POSAGION EON 2s. a a eas Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 6=Print 7=Rename 
9=Create overlay 


Source 
Opt Overlay Text Changed 
2 STATIONERY Sample Form number 3 12/12/90 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 
F12=Cancel 


Ne 


Example Actions: 
1. Type 2 in the Opt column next to the source overlay name STATIONERY. 
2. Press the Enter key. 


The Change Source Overlay display appears. 


c Change Source Overlay 
FIl@) <2: «ee aoe oe ae ~ OVERTLE 
brary. ce, ea meee OS OVLLIB 
Source overlay ....... : STATIONERY 


Type options, press Enter. 
1=Select 


Opt Action 


Define overlay specifications 
Work with source overlay fonts 


F3=Exit F5=Refresh F9=Select all F12=Cancel 
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Example Action: Press the Enter key. 


The Design Overlay display appears. 


a Design Overlay Columns: 1- 74 ) 
Control .. Source overlay ..... STATIONERY 
Aecrere tenner rer eee te arhineeraveie craven ch eyatcte Sister sae stctauctel eater sreptietctste1) ser sieck wonce Ole terest swe re muarct 
001 
002 *T0Q01 Stationery Co., Ltd. 
003 
004 *T002 rd Stationery Sales Slip Date: / / 
005 *LQQ3 ------------------------ *L026 -- 
006 
007 *BQ04 ----------- *LQ17 ------- poccecceee- *L020 -------- + 
008 : *T021 : *7022 ty : *T023 : *7025 ($+): 
009 : f : *T024 5 
010 *L012 ----------- poco ecc renee pecceeceen- poececceen----- 
011 *T013 oint Pen : ‘ fl 
012 *LQ11 ----------- poccececnee-- poscecnnee- posecenn------- 
013 *T014 : : : z 
014 *LQ10 -----------:------------:----------1-------------- 
015 : *T015 
016 *LQ09 -----------:------------3----------1-------------- 
017 *T016 
More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 
ee 2 


Example Actions: 
1. Move the cursor to position (Across : 60, Down 1) to place the logo. 
2. Press the F13 key. 


A % appears at the cursor position, a message prompts you to press the F9 key, 
and the function key area changes. 


a Design Overlay Columns: 1- 74 ) 
Control .. . Source overlay ..... STATIONERY 
Aeep dmc predows erecbret stove Drone tere chiere cre Sisnerece ct cteuene Gh sierevachicnstarsi0 eseeeak srokess Ole reicroctusne stay -etanct 
001 % 
002 *T0Q01 Stationery Co., Ltd. 
003 
004 *T002 rd Stationery Sales Slip Date: / / 
005 *LQ03 ------------------------ *L026 -- 
006 
007 *BO04 ----------- *LOQ17 ------- poreccnn--- *L020 -------- + 
008 : *T021 : *7022 ty =: *T023 : *T025 ($+): 
009 : : : *T024 H 
010 *LQ12 ----------- poceeeennee-- pocceecece- pocecene------- 
011 *T013 oint Pen : ‘ i 
012 *LQ11 ----------- pocceeenne--- poccecceee- posneenn------- 
013 : *T014 5 : : : 
014 *LQ10 -----------:------------1----------:-------------- 
015 2 #1015 
016 *L009 -----------1!------------$ ---------- 5 -------------- 
017 : *T016 
More... 
F3=Exit F6=Place graphics F9=Place page segment F12=Cancel 
F24=More keys 
Press F6 or F9 to place graphics or page segment. 


Ss _ 


Example Action: Press the F9 key. 


The mark %S030 appears in the image area, indicating a page segment, and the 
key entry area is displayed, prompting you to enter a page segment name. 
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& 


Design Overlay Columns: 1- 74 
Control Source overlay ..... STATIONERY 
Rraposaitbi eee acanene tice; orei@scseuarotince gas) Sieve cegch epene ees evectieccee el viv ene stievs ore Olavace ott ster ered sccnecs 
001 %S030 
002 *T001 Stationery Co., Ltd. 
003 
004 *T002 rd Stationery Sales Slip Date: Hae 
005 *LQ03 ------------------------ *L026 -- 
006 
007 *BO004 ----------- *LO17 ------- poceeeceee- *L020 -------- + 
008 *T021 : *T022 ty : *1023 : *7025 ($): 
009 : : : *T024 : 
010 *LQ12 ----------- pocceeceen-e- poececceen- pocceeceee----- 
011 *T013 oint Pen K : A 
012 *LQ11 ----------- Porc ecceen--- peeceeceen- pocceeceee-e--- 
More... 
Place Page Segment 
Maker soe ere ay te e030) Measurement method . . . . : Row/Column 
POSition) er. ah cs, s Across 60 Down 1 
Page Segment . . . QFCLOGO Name 
F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 


Example Actions: 


1. Type QFCLOGO for the Page segment prompt. 
2. Press the Enter key. 


Note: The page segment you specify is not searched for now, but is searched for in 


The mark changes from %5S030 to *S030 to indicate the element has been placed. 


the libraries in the library list when the overlay is printed. See 
for more information. 


fe Design Overlay Columns: 1- 74 = 
Control Source overlay ..... STATIONERY 
Krsje a tivoe wie rete hie erence ccciare tisseigiel Sieve vr ych erence Mivve ave tie cee 0 mvienectave rel Ole reecwitivse ays eiens 
001 *S030 
002 *T001 Stationery Co., Ltd. 
003 
004 *T002 rd Stationery Sales Slip Date: / / 
005 *LQQ3 ------------------------ *L026 -- 
006 
007 *BQQ4 ----------- *LQ17 ------- poceeeceee- *L020 -------- + 
008 *T021 : *TQ22 ty  : *1023 : *7025 ($): 
009 5 . : *T024 : 
010 *LQ12 ----------- poseccnneenn- poceeenee-- poceecnc-o----- 
011 : *T013 oint Pen : . 
012 *LQ1]1 -----------:------------:----------1-------------- 
013 : *TQ14 
014 *LQ10 -----------:------------:----------1-------------- 
015 : *TQ15 
016 *LQQ9 -----------:------------1----------1-------------- 
017 *T016 
More... 
F3=Exit F6=Text F9=Line F10=Box 
a Fll=Bar code F21=Element edit F22=Block edit F24=More keys ) 


52 AFP Utilities for iSeries: User’s Guide 


Example Action: Press the F3 key to complete designing overlay. 


The Change Source Overlay display appears. 


a Change Source Overlay : 
Lill) hotest hoe cucrs err cererts AON aL sal lle 
[DMA ewes cece Cae OVLLIB 
Source overlay ....... : STATIONERY 
Type options, press Enter. 
1=Select 
Opt Action 
Define overlay specifications 
Work with source overlay fonts 
Design overlay 
F3=Exit F5=Refresh F9=Select all 
s/ 
Example Action: Press the F3 key to exit changing a source overlay. 
The Exit Overlay Utility display appears. 
‘a Exit Overlay Utility > 
Type choices, press Enter. 
Option) 5% eh eee ee eS i 1=Save and exit 
2=Exit without saving 
3=Resume Overlay Utility session 
Return to source overlay list. . Y Y=Yes, N=No 
F12=Cancel 
Xe wy 
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Example Actions: 
1. Type 1 for the Option prompt. 
2. Press the Enter key. 


The Save Source Overlay display appears. 


ye 


Type choices, press Enter. 


F4=Prompt F5=Refresh  F12=Cancel 


Ne 


Save Source Overlay 


SOURCES OVER AVC cs fe ere sane: ic Mans STATIONERY Name, F4 for list 

FTA Cie anna oheo aw at saan decays eta nnm tae ores OVLFILE Name, F4 for list 
PSNID Ras ico i we: es eee ny Ser tert on oe OVLLIB Name, *CURLIB 

Text descriptions .9 5 ewe ces: cents Sample Form number 3 

Delete removed elements ...... N Y=Yes, N=No 


Example Action: Press the Enter key. 


The Create Overlay display appears. 


Creating an Overlay from a Source Overlay 


(~ Create Overlay 
Ridi@rer co sate dees eure es eee ee “OVER CINE 
ISD RAN YS Renton ss odes oP ce i rs OVLLIB 
Source overlay. <« s3 < «2% STATIONERY 
MOXE cee aed ie. es esse meenerces eh ies os Sample Form number 3 
Type choices, press Enter. 
Createsoverliay ss ce 3 Ve Y=Yes, N=No 
Overlay vee tes eater ee ce oes STATIONE Name 
[Ei tlt) of=l eh Ae seers ee eeraeralers OVLLIB Name, *CURLIB 
Text 'description’'..... Sample Form number 3 
Includes gridlcc.2 Giver elon ce N Y=Yes, N=No 
Replace if exists ..... N Y=Yes, N=No 
Printoverlay: ss. aise N Y=Yes, N=No 
Authority: 0 Asse ce 8 ce cons *LIBCRTAUT Name, *LIBCRTAUT, *ALL 
*CHANGE, *EXCLUDE, *USE 
F3=Exit F5=Refresh  F12=Cancel 


XX 
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You can create an overlay from this display. Except for the overlay name, the 
default names and text description are the same as those of the source overlay. The 
first eight characters of the source overlay name are used as the default overlay 
name. 


Example Actions: 
1. Type Y for the Create overlay prompt. 
2. Press the Enter key. 


The Work with Source Overlays display appears with completion messages. A + 
character at the end of the message line indicates that there are more messages 
remaining. In this case, the completion message for creating an overlay is the 
remaining message. 


To look at the remaining message, move the cursor to the message line and press 
the Page Down (Roll Up) key. You should look at the remaining messages because 
error messages may be displayed. 


fe > 


Work with Source Overlays 


FeO be eat eee yee et anes ee OVLFILE Name, F4 for list 
aibRawey: ss ies: te So ees OVLLIB Name, *LIBL, *CURLIB 

Source overlay ..... *ALL Name, generic*, *ALL 

Posiitionivto sae Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 6=Print 7=Rename 
9=Create overlay 


Source 
Opt Overlay Text Changed 
STATIONERY Sample Form number 3 12/12/90 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 
F12=Cancel 
C Source overlay STATIONERY saved in file OVLFILE successfully. Ry ) 


Example Action: Press the F3 key. 


The IBM Advanced Function Printing Utilities for iSeries menu appears. 
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Step 5 - Using an Overlay 


Once an overlay is created, there are a variety of ways to place an overlay in AFP 
document applications. Overlays can be referenced in the iSeries printer file, in 
DDS output specifications (using the OVERLAY keyword), with the Advanced 
Print Utility, with page and form definitions, with AFP Toolbox APIs, and with 
numerous third party applications. Refer to the iSeries Guide to Advanced Function 
Presentation and Print Services Facility (5544-5319) for more information on 
application options for AFP documents. 


Overriding a Printer File 


To use an overlay with a printer file, enter an OVRPRIF command to override the 
printer file with the overlay. 


See the CL Reference book for detail of the OVRPRTF command. 


In the following example, the printer file PRINTF is used as an example. You can 
use the name of your own printer file instead. 


Example Actions: 
1. Type OVRPRTF FILE(PRINTF) FRONTOVL(OVLLIB/STATIONE) on the command line. 
2. Press the Enter key. 


Using the Printer File 


To create a spooled file that contains the overlay, use the printer file. Any program 
that uses the printer file will do. 


In the following example, a program CRTPRT is used to create a spooled file. You 
should use the name of your own program that uses the printer file PRINTF. 


Example Actions: 
1. Type CALL CRTPRT on the command line. 
2. Press the Enter key. 


If you do not have a program that uses the printer file, you can try using the 
overlay with system-supplied programs as follows: 


7 Type OVRPRTF FILE(QSYSPRT) FRONTOVL(OVLLIB/STATIONE) on the command line. 
2. Press the Enter key. 
3. Press the Print key. 


When you press the Print key, a system program prints a copy of the displayed 
panel by using printer file QSYSPRT. Thus, overlay STATIONE is printed on the 
hard copy of the display you are seeing. 


You can specify overlays in record formats of a DDS source for the printer file if 


the printer device type is *AFPDS. See iSeries Data Description Specifications Reference 
Version 2, SC41-9620 for more information. 
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Printing Overlays with AFP Utilities for iSeries 


Overlays can be printed using AFP Utilities for iSeries menu option 22, then 
specifying option 6=Print next to the overlay name. To print overlays with Printout 
Format Definitions, select the "Define Printout Specifications” option on either the 
Create PFD Definition or Change PFD Definition panel. Then, specify the overlay 
name and library name for Front side overlay and Back side overlay. 
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Chapter 4. Starting and Ending the Overlay Utility 


This chapter provides additional information for starting and ending the Overlay 


Utility. 


Starting the Overlay Utility 


You can start the Overlay Utility by typing either of the following commands on 


the command line and pressing Enter. 
1. STRAFPU (Start Advanced Function Printing Utilities) 
2. STROVLU (Start Overlay Utility) 


If you start by using STRAFPU, the following display appears: 


‘a AFPU IBM Advanced Function Printing Utilities for iSeries 


Select one of the following: 


Overlay Utility 
1. Work with source overlays 
2. Work with source overlay files 


Print Format Utility 
11. Work with PFD definitions 
12. Work with PFD definition files 
13. Print database file member 
14. Print AFP Utilities tutorial 


Resource Management Utility 
21. Convert to page segment 
22. Work with overlays 
23. Work with page segments 


Selection or command 


===> 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel Fl6=System main menu 
(C) COPYRIGHT IBM CORP. 1991, 1993. 


You can start the following two Overlay Utility functions from this menu: 


Option Function 
1 Work with source overlays 
2 Work with source overlay files 


The following describes the options available on the above menu. To select one of 


the following, type the number of the option on the command line, and press 
Enter. 
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Option 1 (Work with source overlays) 
Work with source overlays allows you to do the following: 


* Create a source overlay. You can start this option by specifying a source overlay 
name with the option number. 


* Change a source overlay. 
* Copy a source overlay. 

* Delete a source overlay. 
* Print a source overlay. 


* Rename a source overlay. 


* Create an overlay object from a source overlay. 


for more information. 


Option 2 (Work with source overlay files) 
Work with source overlay files allows you to do the following: 


* Create a source overlay file by specifying the name of a library and a source 
overlay file name with the option number. 


* Change the description of a source overlay file. 
* Copy a source overlay file. 

* Delete a source overlay file. 

* Rename a source overlay file. 

* Display the description of a source overlay file. 


* Call the Work with Source Overlays display. 


J for more information. 


If you start by STROVLU, the Work with Source Overlays displayed on page lel 
appears. You can skip the Work with Source Overlays display by specifying a 
source overlay name and an option number with the command. 


See [(‘Chapte 4 for more 


information. 


Ending the Overlay Utility 


When you have finished working with the Overlay Utility, press the F3 key 
repeatedly. If you used the STRAFPU command to start the Overlay Utility, the 
menu panel displayed on page 69 appears. 


If you started the Overlay Utility by the STROVLU command, the menu panel 
display on page kl appears. 


To end the Overlay Utility, press the F3 key one more time. Then the screen returns 
to the display from which you started the Overlay Utility. 
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Chapter 5. Work with Source Overlays 


This chapter provides detailed information about the Work with source overlays 
option. 


You can select the following tasks from this display: 
* Create a source overlay 

* Change a source overlay 

* Copy a source overlay 

* Delete a source overlay 

* Rename a source overlay 

* Print a source overlay 

* Create an overlay object from a source overlay 


Note: Before you create a source overlay, you need to create a source overlay file 
by selecting 1 (Create) on the Work with Source Overlay Files display. 


Type 1 (Work with source ey. the IBM Advanced Function Printing 
Utilities for iSeries menu on page and press Enter. The Work with Source 
Overlays display appears: 


‘a Work with Source Overlays *) 
Fil@ 3. go ee ae ew OUFILE Name, F4 for list 
Library a «3 ose 4 os OULIB Name, *LIBL, *CURLIB 
Source overlay ..... *ALL Name, generic*, *ALL 
Position to: sa. ts A a Starting characters 
Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 6=Print 7=Rename 
9=Create overlay 
Source 
Opt Overlay Text Changed 
OVL1 Overlay 1 12/12/90 
OVL2 Overlay 2 12/12/90 
OVL3 Overlay 3 12/12/90 
OVL4 Overlay 4 12/12/90 
More... 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 
F12=Cancel 
ie 2 


The following tables describe the Work with Source Overlays display. 
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Prompts 


Table 3. Work with Source Overlays prompts 


Field Name 
File 


Library 


Source overlay 


Position to 


Description 


Specifies the source overlay file that contains the source overlays you 
want to list and work with. 


Press F4 to go to a selection list of source overlay files in the specified 
library. 

Specifies the name of the library that contains the source overlay file 
containing the source overlays you want to work with. The possible 
library values in this field are: 


*LIBL Specifies that the file containing the source overlays you 
want to work with is in one of the libraries in the library list. 


*CURLIB 
Specifies that the file containing the source overlays you 
want to work with is the current library. If no library is 
specified as the current library for the job, library QGPL is 
used. 


library-name 
Specifies the name of the library that contains the file 
containing the source overlays you want to work with. 
Specifies that you want to work with all the source overlays in the 
file or a subset of the source overlays in the file. Choose from the 
following: 


source overlay name 
Specifies a source overlay name for a display with only that 
source overlay name in the list. 


generic name 
Specifies a partial name of the source overlay name qualified 
by an asterisk (*) to display a specific subset of source 
overlays. The generic name is the following format: 


ABC* 


The source overlays that begin with the characters ABC such 
as ABC, ABCD, and ABCTEST are shown in the list. 


*ALL — Specifies *ALL to display all the source overlays in the 
specified file. 

Note: The first 8 characters of the source overlay name will be used 

for the overlay (object) name when you create an overlay (object) 

using the option 9 (Create overlay). Any remaining characters are 

discarded. 

This prompt is used for quick repositioning of the list, not for creating 

a subset of the list. Choose one of the following: 


*TOP _ To go to the top of the list. 
*BOT To go to the bottom of the list. 


name or partial name 
Specifies the name or partial name you want to go to in the 
list. The list is positioned to the first name beginning with 
the string specified. 
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Options 


Table 4. Work with Source Overlays options 


Option 


1=Create 


2=Change 


3=Copy 


4=Delete 


6=Print 


7=Rename 


9=Create an 
overlay 


Description 
Creates a source overlay. 


You can create a new source overlay. Type 1 in the Opt column and the 
name of the source overlay you want to create in the first line in the list. 


See g for more information. 
Note: Before you create a source overlay, you need to create a source 
overlay file by selecting 1 (Create) on the Work with Source Overlay 
Files display. 

Changes a source overlay. 


You can change a source overlay and save it with either the same name 
or a new name. That is, you can create a new source overlay based on 
an existing source overlay using this option. It is also possible to save 
the source overlay in a different source overlay file or in a different 
library. Type 2 in the Opt column beside the name of the source overlay 
you want to change. 


6] for more information. 
Copies a source overlay to a new source overlay. 


You can also copy a source overlay to another file, another library, or 
both. Type 3 in the Opt column beside the name of the source overlay 
you want to copy. 


ge 77\ for more information. 
Deletes a source overlay from the source overlay file. 


You can confirm the choice on the next display before deleting it. Type 4 
in the Opt column beside the name of the source overlay you want to 
delete. 


See 4 for more information. 


Prints a source overlay. 


Type 6 in the Opt column beside the name of the source overlay you 
want to print. 


Renames a source overlay name. Type 7 in the Opt column beside the 
name of the source overlays you want to change. 


Creates an overlay object from a source overlay. 


Type 9 in the Opt column beside the name of the source overlay which 
you want to create an overlay object from. 


80] for more information. 
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Columns 


Table 5. Work with Source Overlays columns 
Field Name Description 


Opt Specifies the number of the task in the Opt prompt beside the source 
overlay you want to perform the task with. 


You can type the same option next to more than one source overlay at 
a time, and you can also type different options next to different 
source overlay at the same time. 

Source Overlay Shows a list of all the source overlays in the specified file that meets 
the subset criteria. You can use the top position in the list to type a 
source overlay you want to create or select another option. 

Text The text description of the source overlay is shown. 

Changed The date when you last changed the source overlay is shown. 


Showing a Source Overlay List 


The source overlays can be listed on the lower part of the display by specifying the 
Library prompt and File prompt. When you want to change the content of the list, 
specify the name of a file and library, and press the Enter key. You can page up or 
down the list on the display by specifying the starting characters in the Position to 
prompt. 


Note: When you specify either the Source overlay prompt, File prompt, or the 
Library prompt, you can not specify an option in the Opt column. 


Selecting a Source Overlay from a List 


The list on the display contains the names of all or a specified subset of the source 
overlays that exist in the source overlay file indicated by the File prompt. The text 
that describes the source overlays and the date when the source overlay was last 
changed are also shown in the list. 


When a list is shown, a one-word indicator always appears below and to the right 
of the list to tell you where you are in the list. More... means that there are more 
items after the item currently shown. Bottom means that you are at the end of the 
list. 


Use the Page or Roll keys to move forward or backward through the list. 


If you are creating a source overlay, you can check this list to see what names are 
already used before you choose a new name. You can create a source overlay by 
typing 1 and a source overlay name in the first list position, and you can select 
other source overlays from the list using any of the options except 1 (Create). 


Therefore, you can select one or more names by doing one or both of the 
following: 


* In the Opt column beside the source overlay name in the list that you want to 
use, type the number of the option (task) to be used. 

* In only the first (top) position of the list, type an option number (for the task), a 
source overlay name in the Opt and Source Overlay columns respectively. 
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No 


te: You can create a source overlay by specifying the new source overlay name 
from this display, but you can not create a source overlay file from this 
display. Use the Work with Source Overlay Files display to create a source 
overlay file. If you do not have a library for the source overlay file, use the 
Create Library (CRTLIB) command to create a library. 


1=Create a Sourc 


To 
1. 
2. 


3. 


e Overlay 


create a source overlay, do the following on the display on page kil 
Type 1 in the Opt column in the first line of the list. 


Type the source overlay name in the Source Overlay column in the first line of 
the list. 


Press Enter. 


The Create Source Overlay display appears: 


XX 


Te he eS aa 


Create Source Overlay 


Pill Kot eae tne Menrvererte rt ort xeeerana cies OVLFILE 
[EaDeaitey>) tease eer cemes voce OVLLIB 
SOURCE: OVERTaY soot eo se ee eS STATIONERY 


Type options, press Enter. 
1=Select 

Opt Action 

Define overlay specifications 

Work with source overlay fonts 

Design overlay 


F3=Exit F5=Refresh F9=Select all F12=Cancel 


ey 


On 


this display, you can create a source overlay. By typing a 1 in the Opt column 


of this display, you can go to the Define Overlay Specifications display, the Work 


with Source Overlay Fonts display, or the Design Overlay display. 

Field Name Description 

File Shows the source overlay file name in which the source overlay you 
are creating resides. 

Library Shows the library name that contains the source overlay file in which 


Source overlay 


the source overlay you are creating resides. 
Shows the source overlay name that you are creating. 


1=Select Allows you to take an action or some actions by typing 1 in the Opt 
column. 

Opt Specifies 1 in the Opt column beside the action you want to take. 

Action Shows you the action to be taken by the system when you type 1 in 


the Opt column. 
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Define Overlay Specifications 


Each source overlay has the various specifications to describe itself. These 


specifications are used by the IBM Advanced Function Printing Utilities for iSeries 


throughout designing the overlay. They are also used to determine how the 


overlay is merged onto the user data, such as the offset position and the degree of 


rotation. 
( Define Overlay Specifications | 
Type choices, press Enter. 
Printer type 2 5. as 9 1=4224/4234/4230 
2=3812/3816/3930 
3=3916/4028 
4=3820/3825/3827/3829/3835/3900 
5=3825/3835/3900(image capable) 
6=3831 
7=3935 
9=Not specified 
Characters per inch .... 10.00 5.00, 10.00, 12.00, 13.30, 15.00 
16.70, 18.00, 20.00 
ines: iper-ainehy 2 =, 4) a Aes 6.00 3.00, 4,00, 6.00, 7.50, 8.00, 9.00 
12.00 
Degree of rotation. .... 0 0, 90, 180, 270 
DBCS SO/SI spacing. .... y Y=Yes, N=No 
More... 
F3=Exit F5=Refresh  F12=Cancel 
Ne y/ 


Type choices, press Enter. 


F3=Exit F5=Refresh  F12=Cancel 


Unit. -Of measure: c. 54 4 1 
Data element ........ 1 
Measurement method .... I 
Size: 
Measurement method... . 1 
Wit Stes cee se ae, cep eie) ave eeiaet cs 80 
H@AGiGs couceoncueesesametcsetnas 60 
Offset: 
Measurement method... . 1 
ACROSS 20 Seas itabs bs sions ae 0 
OWI es Ge arava eee ete en ene 0 
Grid: 
Measurement method... . 1 
ACKOSS =<, tw caree santaie en ytd 10 
DOW: % Ss a we SO ee 6 


a EE Ca a ee a a’: 


Define Overlay Specifications 


l=Inch, 2=Centimeter 
l=Inch, 2=Centimeter 
1=Row/Column, 2=Inch/Centimeter 


1=Row/Column, 2=Inch/Centimeter 
1-999 
1-999 


=Row/Column, 2=Inch/Centimeter 


1=Row/Column, 2=Inch/Centimeter 


Bottom 


Using the Define Overlay Specifications display, you can define the overlay 


specifications. 


The information specified on this display is used: 


* When designing the overlay, to check its size and whether or not it is applicable 


for the printer type 


* When creating an overlay object, to generate the appropriate data stream 
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Field Name 


Description 


Printer type 


Characters per inch 


Lines per inch 


Degree of rotation 


Specifies the printer type you are going to use. 


1 4224, 4234, 4230 

2 3812, 3816, 3930 

3 3916, 4028 

4 3820, 3825, 3827, 3829, 3835, 3900 

5 3825, 3835, 3900 with the Advanced Function Image and 
Graphics feature 

6 3831 

7 3935 

9 Not specified 


The specified value is used to: 
* Check if each element is supported by the printer. 
* Create the appropriate data stream to each printer. 


If 9 or *DEFAULT is selected, another panel is displayed to confirm 
or change the following attributes for your printer: 


° Pel density 

° Graphics 

¢ Text color 

* Color shading 

* Vertical right to left format, for DBCS 

* PTOCA Tower 2, Underline, Overstrike, Character enlarge 
* BCOCA, Bar Code Object Content Architecture 


differences of printers. 

Specifies the width of a column. For example, at 12 CPI, each 
column takes one-twelfth inch width. The valid values are 5.00, 
10.00, 12.00, 13.30, 15.00, 16.70, 18.00, and 20.00. 


This value is used to specify horizontal positions when the 
measurement method is Row/Column. 


This value is also used to specify horizontal positions of the text in 
a box element. 

Specifies the distance from one row to the next. For example, 8 LPI 
means that the distance between the bottom of a row and that of 
the next one is one-eighth inch. The valid values are 3.00, 4.00, 6.00, 
7.50, 8.00, 9.00, and 12.00. 


This value is used to specify vertical positions when the 
measurement method is Row/Column. 


This value is also used to specify vertical positions of the text in a 
box element. 

Specifies 0, 90, 180, or 270 for the degrees of clockwise rotation of 
an overlay. 


Chapter 5. Work with Source Overlays 67 


Field Name 


Description 


DBCS SO/SI spacing 


Unit of measure 


Data element 
measurement method 


Size 


Measurement method 


Width 


Height 


Specifies whether or not shift-out (SO) and shift-in (SI) characters 
are printed as blanks. 


Y (Yes) The shift-out and shift-in characters in the text data are 
printed as blank characters. 


N (No) The shift-out and shift-in characters in the text data are not 
printed. They occupy no space in the printout. 


Note: DBCS SO/SI spacing is valid only when the file is a DBCS 
capable file. 
Specifies the unit of measure to use. 


1 Inch 


2 Centimeter 

Specifies the initial measurement method to be used when defining 
or placing elements, such as text, lines, boxes, bar codes, graphics, 
or page segments. The measurement can still be changed on the 
define elements and change elements panels. 


Possible values are: 
1 The initial measurement will be Row/Column. 


2 The initial measurement method will be inch or centimeter 
depending on the value specified for the unit of measure. 

Specifies the size of the overlay by the following: 

« Measurement method 

¢ Width 

* Height 

Specifies the measurement method being used to specify the overlay 

size. 


Possible values are: 


1 Row/Column is used as the measurement method. 

2 Either inch or centimeter is used as the measurement 
method depending on the value specified for the Unit of 
measure. 


Note: To change both the measurement method and its following 
fields, you need to change the value for the measurement method 
and press Enter, before you change the following fields. 

Specifies the horizontal size of the overlay. 


Possible values are: 
* 1 to 999 (columns) 
* 0.10 to 22.25 (inches) 


* 0.10 to 57.79 (centimeters) 
Specifies the vertical size of the overlay. 


Possible values are: 

* 1 to 999 (rows) 

* 0.10 to 22.25 (inches) 

* 0.10 to 57.79 (centimeters) 
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Field Name Description 


Offset Specifies the offset of the overlay in the page by the following: 
¢ Measurement method 
¢ Across 


« Down 
Measurement method Specifies the measurement method being used for the offset. 


Possible values are: 


1 Row/Column is used as the measurement method. 

2 Either inch or centimeter is used as the measurement 
method depending on the value specified for the Unit of 
measure. 


Note: To change both the measurement method and its following 
fields, you need to change the value for the measurement method 
and press Enter, before you change the following fields. 

Across Specifies the value of the horizontal distance from the left edge of 
the logical page to the origin of the source overlay to be created. 


Possible values are: 
* 0 to 999 (columns) 
* 0 to 22.25 (inches) 


* 0 to 57.79 (centimeters) 
Down Specifies the vertical distance from the top edge of the logical page 
to the origin of the overlay to be created. 


Possible values are: 
* 0 to 999 (rows) 
* 0 to 22.25 (inches) 


* 0 to 57.79 (centimeters) 
Grid Specifies the distance between the grid lines by the following: 


¢ Measurement method 
¢ Across 


« Down 
Measurement method Specifies the measurement method being used for the grid. 


Possible values are: 


1 Row/Column is used as the measurement method. 

2 Either inch or centimeter is used as the measurement 
method depending on the value specified for the Unit of 
measure. 


Note: To change both the measurement method and its following 
fields, you need to change the value for the measurement method 
and press Enter, before you change the following fields. 


You can specify to print horizontal and vertical lines with the 
printout to help your designing work. The following fields specify 
the horizontal and vertical distances between grid lines. 

Across Specifies the horizontal distance between vertical lines of grid. 


The valid values are: 

* 1 to 999 (rows) 

* 0.10 to 22.25 (inches) 

* 0.10 to 57.79 (centimeters) 
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Field Name Description 


Down Specifies the vertical distance between horizontal lines of grid. 


The valid values are: 

* 1 to 999 (rows) 

* 0.10 to 22.25 (inches) 

* 0.10 to 57.79 (centimeters) 


The overlay utility displays the required information to define overlay 
specifications. You can type appropriate values and press the Enter key to set the 
overlay specifications. 


Change Overlay Specifications 

You can change overlay specifications of the existing overlay, or you can create a 
new overlay based on the existing source overlay by changing it. Conflicts can 
occur between previously defined elements and changed overlay specifications in 
the same source overlay. This function is usually preferred in the following cases. 


Note: The change operation is similar to the create operation. The only difference 
is that the previously entered parameters are already placed in each field 
when the display appears. See (“De 
for the description of each parameter. 


* Making the overlay size smaller 


When you try to reduce the overlay size from the previously defined values, 
some overlay elements may be positioned outside the newly defined overlay. 
The overlay size is always measured from the origin, the top-left corner of the 
overlay. For example, the overlay elements placed near the right edge or bottom 
of the previous overlay may be positioned outside the newly defined overlay. In 
this case, elements are deleted if their positions extend beyond the overlay 
boundaries. 


The overlay utility displays the confirmation display when such a situation 
occurs to let you enter the delete element operation or cancel the change overlay 
specifications operation. See for more 
information. 


* Changing the unit of measure 


The overlay utility allows you to change the unit of measure in the overlay 
specifications between inches and centimeters. The defined numbers in each 
element do not change. Therefore, some elements are positioned outside the 
overlay when the number specified for the size exceeds the possible maximum 
value for the unit. Also some values may exceed the lower limit of parameters 
such as module width. 

* Changing the printer type 
The overlay utility allows you to change the printer type in the overlay 
specifications. The overlay utility checks the compatibility between previously 
defined overlay elements with the newly specified printer type. If the overlay 
utility finds any mismatched elements, the overlay utility displays the 
confirmation display and lists these elements on the display. You can then delete 
the elements or cancel the change overlay specifications. 
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When the parameter values of the elements become incorrect by changing the 
parameter values of the overlay specifications, a warning message is displayed. 
You can adjust parameter values of those elements by pressing the Enter key, or 
you can change the parameter values of the overlay specifications to correct the 
errors. 


The following table describes the cause of warning messages and the results. 


Table 6. The Cause of a Message and Its Results 


Cause Result 

The Unit of measure changed from 1=Inch to The correct minimum value 0.003 
2=Centimeter and the value for Module width gets too centimeter is used. 

small. For example, 0.001 inches becomes 0.001 

centimeters. 

The Unit of measure changed from 2=Centimeter to The correct maximum value 1 


1=Inch and the value for Module width or Line width gets inch is used. 
too large. For example, 2 centimeters becomes 2 inches. 


The Printer type changed from 1=4224/4234/4230 or The value *DEFAULT is used. 
9=Not specified to another type and the value for Color 
becomes incorrect. For example, 1=Blue is incorrect. 


The Printer type changed from another type to The value 1=Horizontal is used. 
1=4224/4234/4230 , or 2=3812/3816/3930, or 3=3916/4028 

, or 7=3935 and the value for Format becomes incorrect. 

For example, 2=Vertical is incorrect. 


The Printer type changed from 1=4224/4234/4230 , or Blank is used. 
2=3812/3816 , or 3=3916/4028, or 7=3935 , or 9=Not 

specified to another type and the value for Overstrike 

becomes incorrect. For example, X is incorrect. 


The Printer type changed from 1=4224/4234/4230 , or The value N is used. 
2=3812/3816/3930 , or 3=3916/4028 , or 7=3935 , or 9=Not 

specified to another type and the value for Underline 

becomes incorrect. For example, Y is not correct. 


The Printer type changed from 1=4224/4234/4230 , or The value *DEFAULT is used. 
2=3812/3816/3930 , or 3=3916/4028 , or 7=3935 , or 9=Not 

specified to another type and the value for Character 

size becomes incorrect. For example, 1 is not correct. 
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Confirm Delete of Elements 


in Confirm Delete of Elements 
Press Enter to confirm your choices for delete. 
Press Fl2 to return to change your choices. 
Position Position 
Mark Name Across Down Reason 
*TOQO1 135 4 Out of overlay 
*T012 18.03 0.42 Out of overlay 
*T013 18.03 0.83 Out of overlay 
*T014 18.03 1.24 Out of overlay 
*L020 17.00 1.50 Out of overlay 
*B021 2.10 1.50 Out of overlay 
*S$026 LOGO 136 1 Out of overlay 
*BQ29 2512 12:23; Out of overlay 
*G031  GDF1 5.60 1.85 Not supported by printer type 
Bottom 
F12=Cancel 
MS 


The Confirm Delete of Elements display shows the list of the elements to be 
deleted due to a change in the overlay specifications. The Reason column shows 
why the element is to be deleted. 


You can delete these elements by pressing Enter. If you do not want to delete these 
elements, press F12 to cancel, then the Define Overlay Specifications display 


appears. 


Table 7. Confirm Delete of Elements display fields 


Field Name 


Description 


Mark 


Name 


Position Across 
Position Down 


Shows the element mark of the element to be deleted. The mark 
consists of an asterisk (*), a character that shows the element type, a 
three digit number (001 to 999), and a blank. The character for each 
element type is: 


T Text 

L Line 

B Box 

Cc Bar code 

S Page segment 
G Graphics 


Shows the element name that is specified on the Define Element 
Detail display. 

Shows the horizontal starting position of the overlay element. 
Shows the vertical starting position of the overlay element. 
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Table 7. Confirm Delete of Elements display fields (continued) 


Field Name 


Description 


Reason 


Shows the reason the element is to be deleted. 


The values are: 


Out of overlay 
Either horizontal and/or vertical position of the element is 
not within the size of the overlay. 


* If the element is text, bar code, or page segment, its start 
position is outside. 


* If the element is line, box, or graphics, its bottom-right 
corner is outside. 


Not supported by printer type 
The element uses a function that is not supported by the 
specified printer type. 


If the element is graphics, the printer does not support the 
function to print graphics. 


Work with Source Overlay Fonts 


The Work with Source Overlay Fonts display appears. For the work with fonts 


operation, see 


Design Overlay 


You can design a source overlay on the Design Overlay display. In a source 
overlay, you can define the following elements: 


¢ Text 
e« Line 
¢ Box 


* Bar code 
* Page segment 
* Graphics 


For more information about the design operation of a source overlay, see 


Saving a Source Overlay 
When you create a source overlay, do the following to save it. 


Step 1. Press the F3 key on the Design Overlay display. 


Step 2. The Create Source Overlay display appears. 
Press the F3 key. 
Step 3. The following display appears. 
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74 


Exit Overlay Utility 
Type choices, press Enter. 
OPEMOMe ee Ae rocepien tele trcetemecant sues 1 1=Save and exit 
2=Exit without saving 
3=Resume Overlay Utility session 
Return to source overlay list. . ¥ Y=Yes, N=No 
F12=Cancel 


Using the Exit Overlay Utility display, you can specify to: 


* Save the source overlay 


* Exit creating or changing the source overlay without saving it. 


* Resume the overlay utility session. 


Field Name 


Description 


Option 


Return to source 
overlay list 


Specifies how you want to handle the source overlay that you are 
working with: 


1 


Save and exit allows you to save the source overlay that you 
have created. The Save Source Overlay display appears to 
save the source overlay. 


Exit without saving allows you to exit from the task without 
saving the source overlay. Everything you have entered while 
you were designing the overlay is discarded. 


Resume overlay utility session allows you to return to the Create 
Source Overlay display. 


Specifies one of the following selections: 


Y (Yes) Returns to the Work with Source Overlays display. 


N (No) Bypasses the Work with Source Overlays display and returns 


to the display from which you started the overlay utility. 


Step 4. Type 1 in the Option prompt, and press the Enter key. The Save Source 
Overlay display appears. 
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( Save Source Overlay ») 
Type choices, press Enter. 
SOURCE: OVER AY! <) gi cen eec as eee en es OVLI Name, F4 for list 
UG ce poates re: oe: eo euaiex etn nes | Serene an fous OUFILE Name, F4 for list 
[Est ees Ss rees ee cre Nr cc OS RENE ett OULIB Name, *CURLIB 
TeXt: VdeSeriperOM'> x: se. 6) ce, eo ones Overlay 1 
Delete removed elements ...... N Y=Yes, N=No 
F4=Prompt F5=Refresh  F12=Cancel 


On the Save Source Overlay display, you can specify the following: 


Table 8. Save Source Overlay display fields 


Field Name 


Description 


Source overlay 
File 


Library 


Text ‘description’ 
Delete removed 
elements 


Shows the previously selected source overlay name as the default. 
Shows the default file name that was specified for the source 
overlay being created or specifies your own source overlay file 
name in which the source overlay is to be saved. 

Shows the default library name that was specified for the source 
overlay being created or specifies the library name in which the 
source overlay is to be saved. 

Specifies the description of the source overlay. 

Specify Y to delete the elements you removed. The numbers in 
each element mark of the other elements are re-numbered. Then 
the overlay utility saves the overlay. 


Specify N to not delete the elements you removed. 
The default value is N. 


The removed elements are those which you removed by using the 
remove element function. Removed elements are not displayed in 
the screen view, and are displayed with an asterisk (*) after the 
element type in the list view. You can recover removed elements 
with the restore (S) command in the list view. 


Note: All or any one of the fields in the Save Source Overlay can 
be changed. 


Step 5. When you complete the operation in this display and press the Enter key, 
the Create Overlay display appears. 


Step 6. Press the Enter key. The Work with Source Overlays display appears. 
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2=Change a Source Overlay 


To change a source overlay, see the Work with Source Overlays display on page bil 
1. Type a 2 in the Opt column beside the source overlay you want to change. 
2. Press Enter. 


The Change Source Overlay display appears: 
a a 


Change Source Overlay 


Fid@@ cases c te ee te (OURTEE 
brary: cs eS es Se ee OULIB 
Source overlay .......: OVL6 


Type options, press Enter. 
1=Select 


Opt Action 
Define overlay specifications 


Work with source overlay fonts 
1 Design overlay 


F3=Exit F5=Refresh F9=Select all F12=Cancel 


S = 


Using the Change Source Overlay display, you can change the existing source 
overlay by selecting the action_on the above display in the same way you do to 
create a source overlay. See 1 for more 
information. 
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3=Copy a Source Overlay 


To copy a source overlay, do the following on the Work with Source Overlays 
display on page 

1. Type a 3 in the Opt column beside the source overlay you want to copy. 
2. Press Enter. 


The Copy Source Overlay display appears: 
ie = 


Copy Source Overlay 


From file. 2s we ee we ee 6 COURTLE 
[\IDRatY ages cemedecae su eo eaens OULIB 

Sounceoverlay i. 5 6 =. .% 3% “OVET 

TOXt wee ww ee a ww F 6 OVerlay 1 


Hover in| =a pa eae cays Geechee cra OUFILE Name, F4 for list 
EVID Ran Viiensenemee nest age toeis etek rs OULIB Name, *CURLIB, *LIBL 

Source overlay ....... OVL2 Name 

Text 'description’'..... Overlay 2 


F3=Exit F4=Prompt F5=Refresh  F12=Cancel 


Using the Copy Source Overlay display, you can copy the source overlay to a 
source overlay in the same or different file or library. 


When invoked, the Copy Source Overlay function displays a screen showing the 
From File name, the From Library name and the name of the From Source Overlay. 
It also displays the same From File name, From Library name and Source Overlay 
name for the receiving File name, Library name and Source Overlay name. 


In order for the copy request to work correctly, one of the values displayed in the 
Prompt screen must be unique. 
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Table 9. Copy Source Overlay display fields 


Field Name 


Description 


From file 
Library 


Source overlay 
Text 


To file 


From Library 


To Library 


Source overlay 


Text ‘description’ 


Shows the name of the source overlay file that contains the source 
overlay you are going to copy. 

Shows the name of the library containing the file with the source 
overlay you are going to copy. 

Shows the name of the source overlay you are going to copy. 

Shows the text description of the source overlay you are going to 
copy. 

Press F4 to display a selection list of source overlay file names that 
are eligible to receive the copied overlay. This display also shows, for 
the To File, the same name as the From file name, the same name as 
the From Library name and the same name as the Source Overlay 
name. Leave the default To file and library names if the Source 
Overlay is being copied to the same file as the sending file. 

Specifies the name of the library that contains the Source Overlay that 
is being copied. 

Specifies the name of the Library that will receive the copied Source 
Overlay. 


The possible values in this field are: 


*LIBL To specify the Library that will contain the copied source 
overlay is in one of the libraries in the library list. 


*CURLIB 
To specify that the file that will contain the copied source 
overlay is in the current library. If no library is specified as 
the current library for the job, library QGPL is used. 


library-name 
To specify the specific library name you want to copy the 
source overlay to. 
Specifies the new source overlay you are going to copy to. This field 
has the same source overlay name as the from source overlay name. 
Leave the default if you want to copy the source overlay to a 
different file or to different library with the same source overlay 
name. 
Specify a short description of the source overlay in this field or leave 
the default if you want to copy the source overlay with the same 
description as the description of the from source overlay. This 
description is saved with the source overlay and displayed when the 
source overlays are listed to help you identify the source overlays. 


Press the Enter key after you type the choices. 
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4=Delete a Source Overlay 


To delete a source overlay, do the following on the Work with Source Overlays 

display on page bil 

1. Type a 4 in the Opt column beside the source overlay you want to delete. 
You can select more than one source overlay on the display. 

2. Press Enter. 


The Confirm Delete of Source Overlays display appears: 
( a 


Confirm Delete of Source Overlays 


FIDO 2 ge tala ee ee outed ay eves 2) OURTEE 
Eibrary «a we Ge we eS OULIB 


Press Enter to confirm your choices for 4=Delete. 
Press Fl2 to return to change your choices. 


Source 
Opt Overlay Text Changed 
4 OvL2 Overlay 2 12/12/90 
4 OVL3 Overlay 3 12/12/90 
4 OVL4 Overlay 4 12/12/90 


Bottom 
Fll=Display names only —F12=Cancel 


Ne oy 


On this display, all source overlays that you specified to delete are listed for your 
confirmation. Press Enter to confirm your choices for deletion, after which these 
source overlays are deleted. If you do not want to delete these source overlays, 
press F12 to return to the previous display to change your choices. 


Field Name Description 

File The name of the source overlay file in which the source overlay 
resides is shown. 

Library Shows the name of the library containing the source overlay file with 
the source overlay you chose to delete. 

Opt The Opt column showing the delete option which causes the 
confirmation display to be shown. For this display, the option number 
is always 4. 

Source overlay Shows a list of all source overlays you chose to delete. 

Text Shows the text description of the source overlay. 

Changed The latest date you changed the source overlay is shown. 


Press the Enter key to delete source overlays. 
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6=Print a Source Overlay 


To print a source overlay, do the following on the Work with Source Overlays 
display on page bil 

1. Type a 6 in the Opt column beside the source overlay. 

2. Press Enter. 


The specified source overlay is printed. 


7=Rename a Source Overlay 
To rename a source overlay, do the following on the Work with Source Overlays 
display on page 
1. Type a 7 in the Opt column beside the source overlay. 
2. Press Enter. 


The Rename Member display appears. Type the new name of the source overlay in 
the New member prompt. 


9=Create Overlay 


To create an overlay object from a source overlay, perform the following steps on 
the Work with Source Overlays display on page a 


1. Type a 9 in the Opt column beside the source overlay. 
2. Press Enter. 


The Create Overlay display appears: 
ae a 


Create Overlay 


FAG Mra crea cate et coc OURTEE 
[eibRary: cs eS es te OULIB 
Source overlay .......: OVLI 

MEX EP ete sors eer wines OVER ayaiL 


Type choices, press Enter. 


Create overlay ....... Y Y=Yes, N=No 
Overlay: 3 Sos ts Be ce os OVL1 Name 
IIDRARY ye cee: ae) clea os ce ce OULIB Name, *CURLIB 
Text ‘description’ ..... Overlay 1 
Tneludesqride 2s ae os N Y=Yes, N=No 
Replace if exists ..... N Y=Yes, N=No 
Printsoverlay is g6 2s N Y=Yes, N=No 
AULHORTGV: ceee ce, oon ae fee cons *LIBCRTAUT Name, *LIBCRTAUT, *ALL 


*CHANGE, *EXCLUDE, *USE 
F3=Exit F5=Refresh F12=Cancel 


S yy 


Using this display, you can create an overlay object from the source overlay that 
you created using the overlay utility. 
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Field Name 


Description 


File 
Library 
Source overlay 


Text 
Create overlay 


Overlay 


Library 
Text ‘description’ 


Include grid 


Replace if exists 


Print overlay 


Authority 


Shows the source overlay file name in which the source overlay 
resides. 

Shows the library name that contains the source overlay file in which 
the source overlay you are working with resides. 

Shows the source overlay name that you are working with. 

Shows the description text of the source overlay. 

Specify a Y to create the overlay object, type N to not create the 
overlay object. 


By specifying a Y for the create option and pressing Enter, the overlay 
utility creates an overlay from the source overlay. 

Specifies the overlay object name. The default value is provided as 
the first eight characters of the name of the source overlay. 

Specifies the library name to store the overlay object. 

Specifies the description of the overlay object. The default value is the 
same as the text of the source overlay. 

Specify a Y to print out the grid with the overlay. The overlay utility 
creates the grid according to the values specified in the overlay 
specifications. 


The default value is N. 
Specify a Y to save the overlay object in the library unconditionally. 


Specify an N to avoid replacing the object if one of the same name 
exists. 


The default value is N. 

Specify a Y to print the overlay. The overlay utility creates the overlay 
print data stream with spooled file type of *AFPDS for the printer. 
The default value is N. 

Note: The Print Overlay display appears. 

Specifies the authority given to users who do not have specific 
authority to the overlay, who are not on the authorization list, and 
whose user group has no specific authority to the overlay. 


Note: This value is ignored and the current authority remains if you 
are replacing an existing overlay. 
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Field Name Description 


Authority You can specify the following values for this parameter: 


*LIBCRTAUT 
The system determines the authority for the overlay by using 
the value specified on the Create authority prompt (CRTAUT 
parameter) on the Create Library command (CRTLIB) for the 
library containing the overlay to be created. If the value 
specified on the Create authority prompt (CRTAUT parameter) 
is changed, the new value will not affect any existing 
overlays. 


*CHANGE 
Change authority allows the user to perform all operations 
on the overlay except those limited to the owner or 
controlled by object existence authority and object 
management authority. The user can change the overlay and 
perform basic functions on the overlay. Change authority 
provides object operational authority and all data authority. 


*ALL All authority allows the user to perform all operations on the 
overlay except those limited to the owner or controlled by 
authorization list management authority. The user controls 
the existence of the overlay, specifies the security for the 
overlay, changes the overlay, and performs basic functions on 
the overlay. The user cannot transfer ownership of the 
overlay. 


*USE Use authority allows the user to perform basic operations on 
the overlay, such as run a program or read a file. The user is 
prevented from changing the overlay. Use authority provides 
object operational authority, read authority, and execute 
authority. 


*EXCLUDE 
Exclude authority prevents the user from accessing the 
overlay. 


Authorization-list-name 
Specifies the name of the authorization list that is used to 
secure the overlay object to be created. 


An overlay is created from a source overlay. The source overlay consists of: 
* Overlay specifications 
* Font information 


¢ Element definitions 


Press the Enter key to create the overlay. When the overlay object is created 
successfully, the Work with Source Overlays display or the screen before the Work 
with Source Overlays display appears with a message at the bottom of the screen. 
It depends on the value of the Return to source overlay list prompt in the Exit 
Overlay display. 


If any error is found in the input parameters or in the resource selection on the 


screen, the field which contains the error is reversed and an error message appears 
at the bottom of the screen. 
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Chapter 6. Work with Source Overlay Files 


This chapter provides the detail information for the Work with Source Overlay 
Files display. 


From the Work with Source Overlay Files display, you can choose the following 
functions. 


* Creating a source overlay file to contain source overlays 
* Changing the description text of a source overlay file 


* Copying a source overlay file that contains source overlays to another source 
overlay file 


* Deleting a source overlay file 

* Renaming a source overlay file 

* Displaying the description text of a source overlay file 
* Going to the Work with Source Overlays display 


Note: To create a source overlay file, you need a library in which the source 
overlay file will reside. If you do not have any libraries, you can create a 
library by entering CRTLIB (Create library) command on a command line on 
any display. 


To show the Work with Source Overlay Files display, type 2 in the command line 
on the Advanced Function Printing Utilities menu and press Enter. The following 
display appears: 

( ~ 


Work with Source Overlay Files 


Type choices, press Enter. 


IED MAYEV a" te eo Gates: Romces cen sess ce OULIB Name, *USRLIBL, *LIBL, 
*CURLIB, *ALLUSR, *ALL 
PHI oue ean acarce ney Corman os cose *ALL Name, generic*, *ALL 


Parameters or command 
===> 


F3=Exit F4=Prompt F5=Refresh F9=Retrieve  F12=Cancel 
Xe es 


Use this display to select the source overlay files you want to list and work with. 
You can use the Library and File prompts to specify subset criteria. When you press 
Enter, the Work with Source Overlay Files display appears with the list of source 
overlay files. 
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The following table explains each field on this display. 


Table 10. Work with Source Overlay File display fields 


Field Name 


Description 


Library 


File 


Specifies the library that contains source overlay files you want to list and 
work with. Choose from the following: 


library name 
Specifies the name of the library that contains the source overlay 
files you want to work with. 


*USRLIBL 
Only libraries in the user portion of the job’s library list are 
searched. 


*LIBL All the libraries in the user and system portions of the job’s library 
list are searched. 
Note: This value may cause a long response time until the Work 
with Source Overlay Files display appears. 


*CURLIB 
The current library for the job is searched. If no current entry exists 
in the library list, library QGPL is used. 


*ALLUSR 
All "user-defined” libraries are searched. "User-defined" libraries 
include library QGPL, but exclude all other libraries with names 
that begin with the letter "Q.” 
Note: This value may cause a long response time until the Work 
with Source Overlay Files display appears. 


*ALL All libraries in the system, including QSYS, are searched. 
Note: This value may cause a long response time until the Work 
with Source Overlay Files display appears. 
Specifies that you want to work with all source overlay files in the library or 
a subset of source overlay files in the library. Choose from the following: 


source overlay file name 
Specifies a source overlay file name for a display with only that 
source overlay name in the list. 


generic name 
Specifies a partial name of the source overlay file name qualified by 
an asterisk (*) to display a specific subset of source overlay files. The 
generic name is the following format: 


ABC* Display a list of all source overlay files that begin with the 
characters ABC. For example, ABC, ABCD, or ABCTEST. 


*ALL Specifies *ALL to display all the source overlays in the specified 
library. 
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The following display appears by pressing the Enter key on the previous display. 


(~ Work with Source Overlay Files > 
Eiibraryeomeec. tweeters OULIB Name, *USRLIBL, *LIBL, *CURLIB... 
PANG: gage: ea een este ese *ALL Name, generic*, *ALL 
Posiitioni tO .: sss Ae Starting characters 
Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 7=Rename 8=Display description 
12=Work with source overlays 
Opt File Library Text Changed 
OUFILE OULIB File for source overlays 12/12/90 
OUFILE2 OULIB Source overlay file 2 12/12/90 
OUFILE3 OULIB Source overlay file 3 12/12/90 
OUFILE4 OULIB Source overlay file 4 12/12/90 
OUFILE5 OULIB Source overlay file 5 12/12/90 
OUFILE6 OULIB Source overlay file 6 12/12/90 
More... 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 
F12=Cancel 
Ke 7 


The following tables explain each field of the Work with Source Overlay Files 


display. 


Prompts 


Table 11. Work with Source Overlay Files prompts 


Prompt 


Description 


Library 


Specifies the library that contains source overlay files you want to list and 
work with. Choose from the following: 


library name 
Specifies the name of the library that contains the source overlay 
files you want to work with. 


*USRLIBL 
Only libraries in the user portion of the job’s library list are 
searched. 


*LIBL All the libraries in the user and system portions of the job’s library 
list are searched. 
Note: This value may cause a long response time until the Work 
with Source Overlay Files display appears. 


*CURLIB 
Current library for the job is searched. If no current entry exists in 
the library list, library QGPL is used. 


*ALLUSR 
All "user-defined" libraries are searched. "User-defined" libraries 
include library QGPL, but exclude all other libraries with names 
that begin with the letter "Q". 
Note: This value may cause a long response time until the Work 
with Source Overlay Files display appears. 


*ALL All libraries in the system, including QSYS, are searched. 
Note: This value may cause a long response time until the Work 
with Source Overlay Files display appears. 
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Table 11. Work with Source Overlay Files prompts (continued) 


File 


Position to 


Specifies that you want to work with all source overlay files in the library 
or a subset of source overlay files in the library. Choose from the following: 


source overlay file name 
Specify a source overlay file name for a display name with only 
that source overlay file name in the list. 


generic name 
Specify a partial name of the source overlay file name qualified by 
an asterisk (8) to display a specific subset of source overlay files. 
The generic name is the following format: 


ABC* Display a list of all source overlay files that begin with 
the characters ABC. For example, ABC, ABCD, or 
ABCTEST. 


*ALL To display all the source overlays in the specified library. 
This prompt is used for quick repositioning of the list, not for creating a 
subset of the list. Choose one of the following: 


*TOP To go to the top of the list. 
*BOT To go to the bottom of the list. 


name or partial name 
Specifies the name or partial name you want to go to in the list. 
The list is positioned to the first name beginning with the string 
specified. 


Options 


Table 12. Work with Source Overlay Files options 


Option 


Description 


1=Create 


2=Change 


3=Copy 


Creates a source overlay file. Type 1 in the Opt column, and the name 
of source overlay file and library you want to create in the first line in 
the list. 


The Work with Source Overlays display appears after the source 
overlay file is created so that you can create source overlays in the 
source overlay file. See 
more information. 


Note: To create a source overlay file, you need a library in which the 
source overlay file will reside. If you do not have any libraries, you 
can create a library by entering the Create library (CRTLIB) command 
on a command line on any display. 

Changes the description text of a source overlay file. Type 2 in the 
Opt column beside the name of the source overlay file for which you 


the Opt column beside the name of the source overlay file you want 
to copy. When the source overlay file is copied, all source overlays in 
the file are also copied. See 
for more information. 
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Table 12. Work with Source Overlay Files options (continued) 

4=Delete Deletes a source overlay file. Type 4 in the Opt column beside the 
name of the source overlay file you want to delete. You can confirm 
the choice on the next display before deleting the file. When the 
source overlay file is deleted, all source overlays in the file are also 
deleted. See 3 for more 
information. 

7=Rename Changes the name of a source overlay file. Type 7 in the Opt column 
beside the source overlay file you want to rename. 

8=Display Displays the description of a source overlay file. Type 8 in the Opt 

description column beside the name of the source overlay file for which you 


want to display its description. See (8=Display Description of 
for more information. 
12=Work with Starts working with source overlays in a source overlay file. Type 12 
source overlays in the Opt column beside the name of the source ee file which 


contains source overlays you want to work with. See 
for more information. 


Columns 


Table 13. Work with Source Overlay Files columns 
Column Description 


Opt Specifies the number of the task in the Opt prompt beside the source 
overlay file you want to perform the task with. You can type the same 
option next to more than one source overlay file at a time, and you can 
also type different options next to different source overlay files at the 
same time. 

File Shows a list of all the source overlay files in the specified library or library 
list that meets the subset criteria. You can use the top position in the list to 
type a source overlay file you want to create or select another option. 


Note: If a file meets the following four conditions, it is shown on the 
Work with Source Overlay Files display as a source overlay file even if it 
is not created as a source overlay file. 


* The file is a physical file 

* The file is not a source file 
* The file is not a DDM file 
* The record length is 80 


It is recommended to use the file you created using the overlay utility. 


Library The name of the library in which the source overlay file resides is shown. 
Text The text description of the source overlay file is shown. 
Changed The latest date you changed a source overlay in the source overlay file or 


you changed the description text of the source overlay file is shown. 


Specify one of the options in the Opt column and press Enter. 


You can exit from this display by pressing F3 (Exit) or F12 (Cancel). 
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Showing a Source Overlay File List 


The source overlay files can be listed on the lower part of the display by specifying 
the Library field and File field. When you want to change the contents of the list, 
specify the name of file and library, and press the Enter key. You can page up or 
down the list on the display by specifying the starting characters in the Position to 
prompt. 


Note: When you specify either the File field or the Library field, you can not 
specify the Opt column. 


Selecting a Source Overlay File from a List 


The list on the display contains the names of all or a specified subset of source 
overlay files that exist in the library (or libraries) indicated by the Library prompt. 
(However, only the source overlay files and libraries for which you have the 
necessary authority are shown.) The text that describes the source overlay files and 
the date the file was last changed are also shown in the list. 


When a list is shown, a one-word indicator always appears below and to the right 
of the list to tell you where you are in the list. More... means that there are more 
items after the item currently shown. Bottom means that you are at the end of the 
list. 


Use the Page or Roll keys to move forward or backward through the list. 


If you are creating a source overlay file, you can check this list to see what names 
are already used before you choose a new name. You can create a source overlay 
file by typing 1, a source overlay file name, and a library name in the first list 
position. You can select other source overlay files from the list using any of the 
options except 1 (Create). 


Therefore, you can select one or more names by doing one or both of the 

following: 

* In the Opt column beside the source overlay file name in the list that you want 
to use, type the option number (task) to be used. 

* In only the first (top) position of the list, type an option number (for the task), a 
source overlay file name and a library name in the Opt, File, and Library columns 
respectively. 
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1=Create Source Overlay File 


To create a source overlay file do the following on the Work with Source Overlay 


Files display. 


1. Type a source overlay file name in the File column, and a library name in the 
Library column in the first line of the list. 


2. Type a 1 in the Opt column. 


3. Press Enter. 


The Create Source Overlay File display appears: 


fe Create Source Overlay File = 
RUUG! open ee is eee ws eee wee OUFILE 
[aibRarys sar peat cakes enue exe os OULIB 
Type choices, press Enter. 
User specified DBCS data. . N Y=Yes, N=No 
Text 'description’..... File for source overlay 
AUEMOISICY Sit tenee eeney caresses *LIBCRTAUT Name, *LIBCRTAUT, *ALL 
*CHANGE, *EXCLUDE, *USE 
F3=Exit F5=Refresh  F12=Cancel ) 


Using the Create Source Overlay File display, you can create a source overlay file 
from the information specified on this display. 


The Work with Source Overlays display appears after the source overlay file is 
created so that you can create source overlays in the source overlay file. 


The following table explains each field of the Create Source Overlay File display. 


Table 14. Create Source Overlay File display fields 


Field Name 


Description 


File 
Library 


User specified 
DBCS data 


Text ‘description’ 


Shows the name of the source overlay file you are going to create. 
Shows the name of the library in which the source overlay file is 
created. 

Specifies N (No) or Y (Yes) in this prompt to specify whether or not 
Double-Byte Character Set (DBCS) data is used in the text data of the 
source overlay in the source overlay file. 


Note: This prompt appears only when your system is DBCS capable. 
Specifies a short description of the source overlay file in this prompt. 
This description is saved with the source overlay file and displayed 
when the source overlay files are listed to help you identify the source 
overlay files. For example, type a short description of your source 
overlay file, such as: 


Practice source overlay file. 
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Table 14. Create Source Overlay File display fields (continued) 


Field Name 


Description 


Authority 


Specifies the authority you are giving the users who do not have 
specific authority to the file, who are not on the authorization list, and 
whose users’ group has no specific authority to the file. The possible 
values are: 


*LIBCRTAUT 


*ALL 


The system determines the authority for the file by using the 
value specified on the Create authority prompt (CRTAUT 
parameter) on the Create Library command (CRILIB) for the 
library containing the file to be created. If the value specified 
on the Create authority prompt (CRTAUT parameter) is 
changed, the new value will not affect any existing files. 


The user can control the file’s existence, specify the security 
for the file, change the file, change the owner for the file, and 
perform basic functions on the file. ALL authority allows the 
user to perform all operations on the file except those limited 
to the owner or controlled by authorization list management 
rights. 


*CHANGE 


The user can change the file and perform basic functions on 
the file. CHANGE authority allows the user to perform all 
operations on the file except those limited to the owner or 
controlled by object existence authority and object 
management authority. CHANGE authority provides object 
operational authority and all data authority. 


*EXCLUDE 


*USE 


EXCLUDE authority prevents the user from accessing the file. 


The user can perform basic operations on the file, such as 
read a file. The user is prevented from changing the file. USE 
authority provides object operational authority and read 
authority. 


authorization-list-name 


Specify the name of an authorization list. Users included on 
the authorization list are those granted authority to the file as 
specified by the list. The authorization list must exist when 
the file is created. 


Press the Enter key after you specify the choices. 
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2=Change Source Overlay File Description 


To change the source overlay file description, do the following on the Work with 
Source Overlay Files display. 


1. Type a 2 in the Opt column beside the source overlay file for which you want 
to change the description. 


2. Press Enter. 


The Change Source Overlay File display appears: 
(~ > 


Change Source Overlay File 


Riles. teen eee, COURTEE 
[Eaibreainys” ees se ee cer ss. vem cones OULIB 


Type choices, press Enter. 


Text 'description’..... File for source overlays 


F3=Exit F5=Refresh  F12=Cancel 
Ne By 


Using the Change Source Overlay File display, you can change the description text 
of a source overlay file. 


Specifies a new text description of the source overlay file. 


The following table explains each field of the Change Source Overlay File display. 
Table 15. Change Source Overlay File display fields 


Field Name Description 

File Shows the name of the source overlay file you are going to change. 

Library Shows the name of the library in which the source overlay file 
resides. 

Text ‘description’ Specifies the User-defined text that briefly describes the file and its 


function. The text specified here replaces any previous text. 


Press the Enter key after you specify the choices. 
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3=Copy Source Overlay File 


To copy a source overlay file, do the following on the Work with Source Overlay 

Files display. 

1. Type a 3 in the Opt column beside the name of the source overlay file you want 
to copy. 

2. Press Enter. 

(a 4 


Copy Source Overlay File 


Rromvbtler 2 vnc cee cee OURTLE 
laibrary cee ss Se a Se ee OULIB 
MONE Kon he sco eueese ssi nshremce™ ages oeue ts File for source overlays 


TOs TAGS zs a ees ES Gee es oe OUFILE2 Name 
LEWD Oye ates, are eens eee ess OULIB Name, *CURLIB 
Text. "deseriiption <4. <..46 <s File for source overlays 


F3=Exit F5=Refresh  F12=Cancel 
Se yy 


Using the Copy Source Overlay File display, you can copy a source overlay file to 
a new source overlay file. The entire set of source overlays will be copied to the 
new file. 


The following table explains each field of the Copy Source Overlay File display. 
Table 16. Copy Source Overlay File display fields 


Field Name Description 

From file Shows the name of the source overlay file you are going to copy from. 
Library Shows the name of the library in which the source overlay file resides. 
Text Shows the text description of the source overlay file being copied. 

To file Specifies the new source overlay file you are going to copy to. This 


prompt has the same file name as the from file name. Leave the 
default if you want to copy the file to a different library with the same 
file name. 

Library Specifies the library you are going to copy the source overlay file to. 
This prompt has the same library name as the from library name. 
Leave the default if you want to copy the file to a different file in the 
same library. The possible values in this field are: 


*CURLIB 
The current library for the job is used to store the copied file. 


name The specified library name is used to store the copied file. 
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Table 16. Copy Source Overlay File display fields (continued) 

Text ‘description’ Specify a short description of the source overlay file in this prompt or 
leave the default if you want to copy the file with the same file 
description as the from file description. This description is saved with 
the source overlay file and displayed when the source overlay files are 
listed to help you identify the source overlay files. 


Press the Enter key after you specify the choices. 


4=Delete Source Overlay File 


To delete a source overlay file, do the following on the Work with Source Overlay 

Files display. 

1. Type a 4 in the Opt column beside the name of the source overlay file you want 
to delete. 


2. Press Enter. 


The Confirm Delete of Source Overlay Files display appears: 
es a 


Confirm Delete of Source Overlay Files 


Press Enter to confirm your choices for 4=Delete. 
Press Fl2 to return to change your choices. 


Source 

Overlay 
Opt File Library Text Changed 
4  QUFILE2 OULIB Source overlay file 2 12/12/90 
4  OQUFILE3 OULIB Source overlay file 3 12/12/90 
4  OQUFILE4 OULIB Source overlay file 4 12/12/90 


Bottom 
Fll=Display names only  F12=Cancel 


Ne a 


Using the Confirm Delete of Source Overlay Files display, you can confirm that 
you want to delete the files you chose by selecting option 4 (Delete) on the Work 
with Source Overlay Files display. 


Note: You can delete only the source overlay files for which you have the 
authority to do so. If you do not have *OBJOPR and *OBJEXIST authority 
for a source overlay file, that source overlay file is not deleted. 


You should use the displayed list of names to verify that you want to delete all of 
the source overlay files shown. If all of them are to be deleted, press Enter to 
delete them. If any of them should not be deleted, press F12 (Cancel). If you press 
F12, you return to the Work with Source Overlay Files display with all selections 
still shown, and you can remove 4 from the column beside the source overlay file 
you do not want to delete. 
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The following table explains each field of the Confirm Delete of Source Overlay 
File display. 


Table 17. Confirm Delete of Source Overlay File display fields 


Field Name Description 

Opt The option field shows the delete option which causes the 
confirmation display to be shown. For this display, the option number 
is always 4. 

File Shows a list of all source overlay files you chose to delete. 

Library Shows the name of the library in which the source overlay file resides. 

Text Shows the text description of the source overlay file. 

Changed The latest date you changed a source overlay in the source overlay file 


or you changed the description text of the source overlay file is shown. 


Press the Enter key to delete them, or press the F12 key to cancel the operation. 


7=Rename Source Overlay File 
To rename a source overlay file do the following on the Work with Source Overlay 
Files display. 
1. Type a 7 in the Opt column beside the source overlay file. 
2. Press Enter. 


The Rename Object display appears. Type the new name of the source overlay file 
in the New object field. 


8=Display Description of Source Overlay File 


To display the description of the source overlay file, do the following on the Work 
with Source Overlay Files display: 


1. Type 8 in the Opt column beside the source overlay file for which you want to 
display the description. 


2. Press Enter. 


The display object description (DSPOBJD) command is called and the description 
of the source overlay file is displayed. 


12=Work with Source Overlays 


You can start working with source overlays from the Work with Source Overlay 
Files display by the following steps: 


1. Type 12 in the Opt column beside the source overlay file that contains the 
source overlay you want to work with. 


2. Press Enter. 


The Work with Source Overlays display appears. 


for more information. 
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Part 3. Print Format Utility 


Chapter 7. Introduction to Print Format Utility . 
Printout Format Definition (PFD Definition) 

PFD Specifications . ne 

PFD Definition Fonts . 

Database File . 

Record Layout 

Page Layout . 

Elements . 

Record Selection 

Printout Specifications 

Mapping Object Name 

Printing with Print Format Utility 
Operation Flow. 


Chapter 8. Getting Started with Print Format Utility 
Step 1 - Starting the Print Format Utility 
Step 2 - Creating a PFD Definition File . 
Step 3 - Creating a PFD Definition 
Specifying a Database File . 
Designing a Record Layout. 
Specifying Fixed Text Data . 


Specifying Variable Text Data from a apatabese File Record 


Specifying a Page Segment . 
Specifying a Bar Code Element 
Specifying a Box Element 
Element Selection . : 
Specifying a Line Element . . 
Exiting from Design Record Layout . 
Designing a Page Layout 
Defining Printout Specifications . 
Exiting from Defining the PFD Definition . 
Step 4 - Printing a Database File . 
Step 5 - Ending the Print Format Utility 
Step 6 - Printing the AFP Utilities tutorial . 


Chapter 9. Starting and Ending the Print Format has : 


Starting the Print Format Utility . 3 
Option 11 (Work with PFD ae nitone) 
Option 12 (Work with PFD definition files) 
Option 13 (Print Database File Member) 
Option 14 (Print AFP Utilities tutorial) . 

Ending the Print Format Utility 


Chapter 10. Work with PFD Definitions . 
Prompts . 
Options 
Columns . 
Showing a PFD Definition Like 
Selecting a PFD Definition from a List . 
1=Create PFD Definitions 
Define PFD Specifications 
Change PFD Specifications . 
Confirm Delete of Elements 
Work with PFD Definition Fonts . 
Specify Database File . 
Select Database File 
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Select Record Format. 
Specify Break Fields . 
Design Record Layout 
Data in Record Layout 
Numeric Editing 
Design Page Layout . 
Repetition of the Recoid'? in ‘hie Page. 
Specify Record Selection. 
Define Printout Specifications . 
Specify Mapping Object Name 
Saving PFD Definition 
2=Change PFD Definition . 
3=Copy PFD Definition . 
4=Delete PFD Definition. 
6=Print PFD Definition . 
7=Rename PFD Definition . 
9=Print Database File. 


Chapter 11. Work with PFD Definition Files 
Prompts . ou te go eB ke GS 
Options 

Columns . : 
Showing a PFD Dediition File List : 
Selecting a PFD Definition File from a List 
1=Create PFD Definition File . 

2=Change PFD Definition File . 

3=Copy PFD Definition File 

4=Delete PFD Definition File . 

7=Rename PFD Definition File. : 
8=Display Description of PFD Definition File. 
12=Work with PFD Definitions . 


Chapter 12. Print Database File Member 


Start Printing from Work with PFD Definitions Display 


Start Printing from the AFP Utilities Menu 
Start Printing by PRIPFDDTA. 
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Chapter 7. Introduction to Print Format Utility 


The Print Format Utility enables you to develop AFP applications directly from 
database files. In a manner similar to Query for iSeries, database records are 
selected and processed into full pages of output combining variable data, text, 
overlays, bar codes, lines, boxes, image, and graphics. All of the instructions built 
during the Print Format Utility design process are stored as print format 
definitions (PFD). The ability of the Print Format Utility to design individual 
record layouts and then replicate those layouts across and down the page make it 
very productive with applications such as multiple-up barcoded labels. 


In addition to the data from database file members, you can print fixed data that is 
defined by any of the element types (text, boxes, lines, bar codes, page segments, 
or graphics). Examples of fixed data are: 


* Titles 
* Company logos 
° Drawings 


You can also print variable data that are not defined in the database member, such 
as: 


* Job date 

* Job time 

* Page number 

* Record number 

* Database file name 

* Database library name 


¢ Database member name 


To print data with the Print Format Utility, you need to create a PFD definition to 
specify the print format of the data from the menu panel display interactively. 


Printout Format Definition (PFD Definition) 


A PFD definition provides the necessary information about the data, forms, and 
formats which you want to print. 


You need to provide the following information in a PFD definition. 


PFD Specifications 
The specifications contain the following: 
* Printer type 
* Characters per inch 
* Lines per inch 
* Degree of rotation 
¢ Whether or not you want page numbers on each page 
* Unit of measure 
* Initial element measurement method 


* Page size 
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* Offset 
* Grid (design aid) position 


If nothing is specified, the default values are used. 


PFD Definition Fonts 


Fonts are predefined, but you can change PFD definition fonts if you want. 


Database File 


You can specify which fields of data in the database file are printed. 


You can specify the name of the database file, library, and record format. If you do 
not specify them in a PFD definition, you need to specify them when you print a 
database file member. You can also specify fields in the database file to cause a 
page break. 


Record Layout 


The Print Format Utility manages two kinds of records which are distinguished 
depending on their definitions as follows: 


¢ The record defined in the database file. It is referred to as a "database file 
record.” 


* The record defined by Print Format Utility as a unit or set of data to be printed. 
It is simply referred to as a "record.” A record consists of data from a database 
file record and other data such as text, lines, boxes, and bar codes you define for 
the record. 


You must define how you lay out the data, which are called elements, in a record 
as a record layout. 


For example, you can print the following label from a record in a database file 
member using Print Format Utility. 


A Database File 


Record ColorTV 980 20 
ALabel 

Product : Color TV 

Price 2 980 


WU TIIID IV | <a 


Figure 15. Record Layout Sample 


On the above label, the product name ‘Color TV’, the price ‘980’, and the bar code 
which is coded from the price are picked up from the fields in the database file 
record. Other data in the label such as ‘Product :’, “Price :’, lines, and logos are 
defined in this record for the label independently of the data in the database file 
record. 
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You can also print some variable data such as job date, job time, page number, 
record number, database file name, library name, and member name by specifying 
character strings which are called reserved variable names in the text data on a 
text element or a box element. 


Page Layout 


You must also define how to lay out the records, which are described in the 
previous section, in a page as a page layout. You need to specify where and how 
many times to place the defined records in a page. You can specify the fixed data 
such as text, lines, boxes, bar codes in the same way as you specify them in a 
record. 


The following figure shows the sample page: 


Product :ColorTV Product : AM Radio 


Price =: 98 Price 3 10 


Me BULL 


Product : FM Radio Product : Video 


Price Price 


WINN “MUNI | a 


Product :Video2 Product :CD player 


Price Price 


“PMI 20 “WIMUN | 3 


Product :Ball point pen Product : Pencil 


Price Price 


Te “PMU 


Figure 16. Page Layout Sample 


You can print some variable data such as job date, job time, page number, record 
number, database file name, library name, and member name by specifying 
character strings which are called reserved variable names in the text data on a 
text element or a box element. 
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You can also print variable data, such as the field value of the first record in the 
group, the field value of the last record in the group, the total of the field values in 
the group, the average of the field values in the group, the maximum field value in 
the group, the minimum field value in the group, and the record counts of the 
group, by specifying character strings which are called summary data in the text 
data on a text element or a box element. 


Elements 


The record layout and the page layout are defined by placing text, page segments, 
lines, boxes, graphics, or bar codes, which are called elements. 


The data in the database file record can be specified as text elements, bar code 
elements, the text in box elements, page segments, or graphics elements in a record 
layout. 


The fixed data can be specified as text elements, line elements, box elements, bar 
code elements, page segment elements, or graphics elements in the record layout 
or the page layout. 


If you print data in a field as a text element, text in a box element, a bar code 
element, a page segment, or a graphics element, specify the field name which is 
appended by an ampersand (&) before the name and a period (.) after the name as 
a parameter of the element data. 


Zi for more information. 


Record Selection 


You can specify a condition for the field in the database file record to select data in 
the field to be printed. When you don’t specify this option, all data in the database 
file record is printed. 


Printout Specifications 


The Define Printout Specifications display allows you to define how the printout 
will be printed, such as: 


* Number of copies 
* Print quality 
¢ Source drawer 


Mapping Object Name 
You can specify a field name as any of the following object names: 
* Page segment 
* Folder 
* PC document 
° Library 
° File 
* Member 
The value of the field in the input database file is used as the object name. In some 


cases, the values in the database file may not be appropriate for object names. For 
example, values like ’A.B.C’ or IBM Corporation’ cannot be object names. You do 
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not need to change the data in the database file. Instead, you should specify 
mappings from these values to object names on the Specify Mapping Object Name 
display. 


Printing with Print Format Utility 


The Print Format Utility allows you to save the PFD definition as an iSeries file 
member so that the same definition can be used the next time you print a database 
file member. Once you save a PFD definition, you can make a new PFD definition 
based on the PFD definition by changing it from the display. 


You can print various kinds of printout from one database file member by 
preparing various PFD definitions. For example, you can create a list of products, 
product descriptions, and delivery labels as shown below from one by using 
different printout format definitions. 


Kee Kee * 
| 

Keene ee - - - - - - +------------------------- * 

| | | 

V V V 
Ke---------- * Kee ------- * ke---------- * 
| Print Print | | Print | 
| Operation Operation | | Operation | 
Ke---- Ken * Ke---- *Ke---- * ke---- Ke---- * 


<-*PFD definition 1 <-*PFD definition 2 <-*PFD definition 3 


Output 1 Output 2 


List of products 


Kee --- *e---- * kee ------- * kee * 
|Product Name|Price| Product name: | Color TV AM Radio | 
#ea----------- +----- * [| -e-------------- 300 20 
Color TV 300 | Color TV | | | il il | | 
AM Radio 20] | | ---------------- 
| Video 500| | Price : $300 | | *---------- a x | 
: : Country : U.S.A. Kae-- HHH -- # k---------- * 
| | | Stock :  XXXXxx | | Video | |CD Player | 
| | | : : | | | 500 | | 100 | | 
kee ------- * kee * 
Kee --- *e---- * 
Kee eee ee ee * Kee ee * Kee - * 
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Operation Flow 


Figure 17 shows the overview of the print format utility operation. 
Figure 17. Overview of Print Format Utility Operation 


Step 1 - Define PFD 
specifications 

| and fonts 
- Specify database file 


| - Specify break fields 


| 

| | Place element on | | 
| the record layout | 
| 

| 


Define contents 
of element 


| 
| 
Step 2 | 
| 
| 


Place element on 
the page layout 


Step 3 


| Define contents 
| of element 


Step 4 | - Specify record | 
| selection | 
| - Define printout 

specifications 

- Specify mapping 

object name 


Step 5 Save a PFD 


definition 


Step 6 | Print a | 
| database file | 
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Step 1. 


Step 2. 


Step 3. 


Step 4. 


Step 5. 


Step 6. 


This is an optional step. 

You can change the default values of the PFD specifications; such as the 
offset, the lines per inch (LPI), the characters per inch (CPI), the unit of 
measure, the DBCS SO/SI spacing, the degree of rotation, and the printer 
type. See (De 49) for more information. 


You can = the fonts used to print text. See Chapter 14. Work withl 


for more information. 


You can specify the database file to be printed. Though this is optional, it 
is encouraged to specify the database file because you can easily specify 
field names in step 2. See 8 for more 
information. 


You can also specify fields in the database file which cause page breaks. 


Design the record dieu 


Repeat the following operations: 

a. Position the cursor on the screen where you want to enter an element 
such as text, box, and so on. 

b. Place the element in the record layout by pressing the function key 
assigned for the element. 


c. Type the element specification. After entering the data, a mark is 
assigned for the element by the Print Format Utility. The mark is 
placed at the element position on the screen. 


for more information. 


Design the page tyne 


Repeat the following operations: 

a. Position the cursor on the screen where you want to enter an element 
such as text, box, and so on. 

b. Place the element in the page layout by pressing the function key 
assigned for the element. 

c. Type the element specification. After entering the data, a mark is 
assigned for the element by the Print Format Utility. The mark is 
placed at the element position on the screen. 


for more information. 


You can specify which records to print by specifying up to five logical 
conditions. See j for more 
information. 


You can change the default values of the printout specifications; the 
number of copies, the print quality, and the source drawer. See [Defind 


hemierias eerie for more information. 
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The following chapters show you how to: 


* Get started with the Print Format Utility and use it by practically performing an 
exercise 


* Start and end the Print Format Utility 
* Work with a PFD definition 
— Create a PFD definition 
- Define PFD specifications 
- Work with PFD definition fonts 
- Specify database file and record format 
- Specify break fields 
- Design a record layout 
- Design a page layout 
- Specify record selection 
- Define printout specifications 
- Specify mapping object name 
— Change a PFD definition 
— Copy a PFD definition 
— Delete a PFD definition 
— Rename a PFD definition 
— Print a PFD definition 
* Work with a PFD definition file 
— Create a PFD definition file 
— Change a PFD definition file description 
— Copy a PFD definition file 
— Delete a PFD definition file 
— Rename a PFD definition file 
— Display a PFD definition file description 
— Work with PFD definitions 


e Print a database file member 


While using IBM Advanced Function Printing Utilities for iSeries, you can press 
the F1 key to display help information. 
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Chapter 8. Getting Started with Print Format Utility 


This chapter describes how to print data from a database file member with the 
Print Format Utility by showing a practical printing exercise. 


The operational steps of printing with the Print Format Utility are as follows: 
Step 1. Starting the Print Format Utility 
Step 2. Creating a PFD definition in a library. 


Step 3. Creating a PFD definition in a PFD definition file that you created in step 
. This step consists of the following sub-steps: 


N 


Specifying a database file 
Designing a record layout 
Designing a page layout 


aoop 


Defining printout specifications 

. Saving a PFD definition 

Step 4. Printing a database file based on the PFD definition. 
Step 5. Ending the Print Format Utility. 

Step 6. Printing the AFP Utilities tutorial. 


Note: If your printer does not support bar codes, you should specify your printer 
type on the Define PFD Specifications display in the creating a PFD 
definition step. AFP Utilities for iSeries generate appropriate data to print 
bar codes on your printer. Refer to IBM Printing Systems: Printer Information, 
(S544-5750), to check if your printer supports them. 


A page segment is needed to perform the following task. Page segment QFCLOGO 
should exist in library QGPL. If it does not exist, copy page segment QFCPAGS 
from library QAFP to library QGPL as page segment QFCLOGO. You can use the 
Create Duplicate Object (CRTDUPOBJ) command to do this. 
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Step 1 - Starting the Print Format Utility 


Example Actions: To start AFP Utilities for iSeries, type STRAFPU (Start Advanced 
Function Printing Utilities) on the command line and press Enter. 


The IBM Advanced Function Printing Utilities for iSeries menu appears: 
fi 


AFPU IBM Advanced Function Printing Utilities for iSeries 
Select one of the following: 


Overlay Utility 
1. Work with source overlays 
2. Work with source overlay files 


Print Format Utility 
11. Work with PFD definitions 
12. Work with PFD definition files 
13. Print database file member 
14. Print AFP Utilities tutorial 


Resource Management Utility 
21. Convert to page segment 
22. Work with overlays 
23. Work with page segments 


Selection or command 
See> 4)?’ 


F3=Exit F4=Prompt F9=Retrieve F12=Cancel F16=System main menu 
(C) COPYRIGHT IBM CORP. 1991, 1993. 


Me 


From this display, you can select any function of AFP Utilities. 


The Print Format Utility functions are: 


Selection Function 

11 Work with PFD definitions 

12 Work with PFD definition files 
13 Print database file member 

14 Print AFP Utilities tutorial 


Before you create a PFD definition, you must create a PFD definition file to store 
it. 


Note: You need a library to store a PFD definition file. MYLIB is used in the 
following example, but you may use the name of your library instead. If 
you do not have any libraries, create a library by typing CRTLIB MYLIB and 
pressing the Enter key. 
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Step 2 - Creating a PFD Definition File 


Example Actions: To create a PFD definition file, type 12 (Work with PFD 
definition files) on the command line on the IBM Advanced Function Printing 
Utilities for iSeries menu and press the Enter key. 


The Work with PFD Definition Files display appears to create a PFD definition file. 


es Work with PFD Definition Files > 


Type choices, press Enter. 


[SDV aIC Viet temas cmes cde ears MYLIB Name, *USRLIBL, *LIBL 
*CURLIB, *ALLUSR, *ALL 
Fai Cates sence tapes enous nregr sees *ALL Name, generic*, *ALL 


Parameters or command 
===> 


F3=Exit F4=Prompt F5=Refresh F9=Retrieve  F12=Cancel 
Ne a 


The library name that you used last is displayed in the Library prompt and *ALL is 
displayed in the File prompt. 


Example Actions: Type MYLIB in the Library prompt and press the Enter key to list 
PFD definition files stored in MYLIB. 


fs Work with PFD Definition Files > 


DRO yee. co ence cies on MYLIB Name, *USRLIBL, *LIBL, *CURLIB... 
Biili@s eee sete ce, wet tes om here *ALL Name, generic*, *ALL 
POSTETONIEO «85 ps ee Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 7=Rename 8=Display description 
12=Work with PFD definitions 


Opt File Library Text Changed 
il PFDFILE MYLIB 


(No PFD definition files in library) 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 


F12=Cancel 
Ne / 


Note: No PFD definition file is shown because no PFD definition files are stored in 
MYLIB. 
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Example Actions: 

1. Type 1 (Create) in the Opt column on the first line of the list. 
2. Type PFDFILE in the File column on the first line of the list. 
3. Type MYLIB in the Library column on the first line of the list. 
4. Press the Enter key. 


The Create PFD Definition File display appears: 


( Create PFD Definition File > 
FivieiA. scot oe eee eee eee) IPEDROLE 
[STD WaIAY 9 Ap es en es once wee ee toes MYLIB 


Type choices, press Enter. 


User specified DBCS data... WN Y=Yes, N=No 
Text 'description’'..... PFD file for exercise 
Authority: <2 % ss Soe x *LIBCRTAUT Name, *LIBCRTAUT, *ALL 


*CHANGE, *EXCLUDE, *USE 


F3=Exit F5=Refresh  F12=Cancel 


From this display you can specify: 
* Whether or not DBCS data will be used (only when you are on a DBCS system). 


* A short description of the PFD definition file up to 50 SBCS characters long. This 
description is saved with the PFD definition file and displayed when the PFD 
definition files are listed to help you to identify the PFD definition files. 


* Authority given to users who do not have specific authority to the PFD 
definition file. 


Example Actions: 
1. Do not change the default value for the User specified DBCS data prompt. 


Note: This prompt appears only when your system is DBCS capable. 
2. Type PFD file for exercise for the Text ‘description’ prompt. 
3. Press the Enter key. 


When the PFD definition file is created, the Work with PFD Definitions display 
appears to create a PFD definition in the file. 
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Step 3 - Creating a PFD Definition 


To print data from a database file, you must create a PFD definition from the Work 
with PFD Definitions display. The AFP Utilities for iSeries print the data according 
to your PFD definition. 


~ Work with PFD Definitions > 


[Balt eee erverentoee s rere trae PFDFILE Name, F4 for list 
LaIDRaRY se a: oh Ge vs MYLIB Name, *LIBL, *CURLIB 

PFD definition: « . « « *ALL Name, generic*, *ALL 

POSTION tOo cc sete ss Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 6=Print PFD definition 7=Rename 
9=Print database file 


PFD 
Opt Definition Text Changed 
1 PRODUCTLBL 


(No PFD definitions in file) 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 
F12=Cancel 


No ed 


For example, the following describes how to create a PFD definition in PFD file 
‘PFDFILE’ located in library "MYLIB’ to print the label below from the database file 
‘QAFCPFDDTA’ in library QGPL. 


A Database File 


RecordinQAFCPFDDTA | ColorTV 980 11 
ALabel 

Product :Color TV 

Price : 980 


YTITTIIV TET |< ava 


Figure 18. Sample Label 


Example Actions: 
1. Type 1 (Create) in the Opt column in the first line of the list. 


2. Type the PFD definition name PRODUCTLBL in the PFD Definition column in the 
first line of the list. 


3. Press the Enter key. 


The Create PFD Definition display allows you to select the action items for creating 
a PFD definition. 
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Create PFD Definition 


Bile 2 eat eae eee cee PEDEUEE 
librarys tee oe MYLIB 
PFD definition. .... . :  PRODUCTLBL 


Type options, press Enter. 
1=Select 


Opt Action 
Define PFD specifications 
Work with PFD definition fonts 


1 Specify database file 

Specify break fields 
1 Design record layout 
1 Design page layout 


Specify record selection 
Define printout specifications 
Specify mapping object name 


F3=Exit F5=Refresh F9=Select all F12=Cancel ) 


The actions with a 1 in the Opt column are the mandatory actions to create a PFD 
definition. Other actions for which the Opt column is left blank are optional. 


Example Actions: 
1. Type 1 in the Opt column beside Define printout specifications. 
2. Press the Enter key. 


The Specify Database File display appears. 


Specifying a Database File 


‘i Specify Database File i. 


Type choices, press Enter. 


Database fille «95 « 4% @ eG x Name, F4 for list 
NIDA "eo Sars de tel ee eo et Os ee QGPL Name, *LIBL, *CURLIB 
Record ‘format: 4. 4< 5 6 = 4 « % *FIRST Name, *FIRST, F4 for list 


F3=Exit F4=Prompt F5=Refresh  F12=Cancel 


Example Actions: 

1. Type QGPL in the Library prompt. 

2. Move the cursor to the Database file prompt and press the F4 key to list the 
database files in library QGPL. 
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Select Database File 
Library? <4: 5 & = wa = a “QGPL 
PoSittioni to! “ssh ee ai Starting characters 


Type option, press Enter. 


1=Select 

Opt File Text 
QAAPFILE Symbol set symbol definitions logical file 
QAAPFILE$ Symbol set small symbol definitions 
QAAPFILE# Symbol set medium symbol definitions 
QAAPFILE@ Symbol set large symbol definitions 
QAFCGRPH SAMPLE GDF 

1 QAFCPFDDTA SAMPLE DATABASE FILE FOR PFU 
QAFCTUTDBF SAMPLE DATABASE FILE FOR TUTORIAL 
QAFCTUTOR AFPU TUTORIAL TEXT 


QAFCTUTPFD AFP Utilities for iSeries tutorial PFD file 
QAFCTUTXMP Sample PFD File 
QAFCXMPAI2 SAMPLE DATABASE FILE (AIAG_B2) 
More... 
F5=Refresh  F12=Cancel 


7 


The database files stored in library QGPL are listed. You can select a database file 
by typing a 1 in the Opt column beside the database file name in the list. 


Example Actions: 
1. Type 1 in the Opt column beside QAFCPFDDTA . 
2. Press the Enter key. 


The Specify Database File display appears again with the selected database file 
name in the Database file prompt. 


(~ Specify Database File ) 


Type choices, press Enter. 


Database Tile 3 m6 & wa ew QAFCPFDDTA Name, F4 for list 
EdD; aetesn shes nee ares “cumeca pss QGPL Name, *LIBL, *CURLIB 
Record TOMmMat Vea 4 a arco ee *FIRST Name, *FIRST, F4 for list 


F3=Exit F4=Prompt F5=Refresh  F12=Cancel 


Example Actions: 


1. Press the Enter key. The value in the Record format prompt changes from *FIRST 
to PRODMASTER. 


2. Press the Enter key. 


The Design Record Layout display appears. 
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Designing a Record Layout 
cc = 


Design Record Layout Columns: 1- 74 
Control .. PFD definition. .... PRODUCTLBL 
His dau APia csacduarstavsttesre coed eel cvedtievelsbe oie areuect cueis eh ercpois chelsea Divs atachalerais|Oistensyact ns: sratiae.suere 
001 
002 
003 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


Ke 


There are two kinds of records which are distinguished depending on their 
definitions as follows: 


¢ The record defined in the database file is referred to as a "database file record.” 


* The record defined by the Design Record Layout process of the Print Format 
Utility will be referred to as a "record" or "record layout.” 


From this display you can specify the layout of the data in a record. Initially, there 
is nothing defined in the record. From this display, you can define the record 
layout, that is, which field of the record in the database file or what kinds of 
elements such as lines, boxes, or bar codes are printed at what location in the 
record. 


The following are different types of data you can specify in a record: 
Variable Data 


Field data from a database file is called variable data. 


Text You can specify not only their locations on the page, but also color, 
direction, and so on. 


Bar Codes 
You can specify not only their locations on the page, but also color, 
direction, and so on. 


Image You can specify the mapping of data in a database file to a page 
segment name. 


Graphics 
You can specify the mapping of data in a database file to the name 
of a folder, a document, a library, a file, or a member. 


Note: Variable data can be specified only in the record layout. 
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Fixed Data 


In addition to the data from a database file, you can define any 
combination of the following elements, which is called fixed data. In a 
record layout, fixed data is not affected by the contents of the database file 
to be printed. 


Text Text with various fonts, underlined or not, color, and so on. 


Line and Box 
With various length, width, dashed/dotted, shaded, and so on. 


Bar Codes 


For the supported bar code types, see /Chapter 13. Design 


Image Stored as page segments. 


Graphics 
Stored as graphics elements. 


Reserved Variable Data 


You can also print variable data, which is resolved during the printing of 
the database file member such as date, time, and record number. You can 
specify this data in the text data of a text element or a box element. 


The label in Figure 18 on page consists of variable data and fixed data as 
shown below. 


1. 


Variable data defined in record layout: 


Text The product name (Color TV), and the price (980). 
Bar code The code (11) is printed as a bar code below the price. 


Fixed data defined in record layout: 


Text ‘Product :’ and ‘Price :’ 
Line Box lines around and between the text elements. 
Image Logo mark at the right bottom. 


The following steps describe the process to create the above sample label. 


Chapter 8. Getting Started with Print Format Utility 113 


Specifying Fixed Text Data 
Example Actions: Move the cursor to the position (Across : 3, Down : 3) where you 
want to place the text element in the display, and press the F6 key. 


The following display appears: 
( Design Record Layout Columns: 1- 74 > 
Control... PED: definition) <1. 3 <:- PRODUCTLBL 
ener toavevencilanaye testi c seicrshacese tue savenctoisdescvech everest atevaie tie lege tel Distercge Rspatete Olesaretertnereets 


001 
002 
003 %T001 
004 


More... 


Define Text 
Mak? ao eee cee, et FOOL Measurement method . . . . : Row/Column 
POSAUTON & os. tase Across 3; Down 3 
Text data ... . Product : 


F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 


The element mark for the text element (%T001) is displayed at the cursor position, 
and the key entry area appears at the bottom portion of the display. A % indicates 
that the element is being worked with. The key entry area contains the information 
of the element you are specifying, such as position. 


The upper area of the display where you can place elements is called the image 
area. The image area shows you an approximate image of the printout. 


Example Actions: 
1. Type Product : in the Text data prompt. 
2. Press the Enter key. 
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The Design Record Layout display appears as follows. 
(~ Design Record Layout Columns: 1- 74 >) 
Control .. PFD definition. .... PRODUCTLBL 
Pope mal se trea ear ret tenance toss Agensteniecbe. ete eileen oene Taare 
001 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


\ es 


The symbol before T001 changes from "%" to "*" which shows you that this text 
element is defined in the record layout. 


Example Actions: In the same way, specify another text element which contains 
"Price :" at (Across:3, Down: 5). 


The following display appears: 
(~ Design Record Layout Columns: 1- 74 ) 
Control . . PFD definition. .... PRODUCTLBL 
Heras oes Hecavarie revavarschicaveie Gueveraect nhcetaea alan cestisvagert Ghievave sch cucvene Ole saetectinrens ol Oicuejsuort aneserslreceens 
001 
002 
003 *TOO1 t: 
004 
005 *T002 
006 
007 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


XX es 


The text "Price :" is partly covered by its mark *T002. 


Note: When you set mark off (F15), only the last mark is displayed and others are 
not displayed. 
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Specifying Variable Text Data from a Database File Record 

Example Action: Move cursor to the position (Across : 13, Down : 3) where you 

want to place the product name on the display and press the F6 key. 

* If you know the field name of the database file record, type an ampersand (&), 
the field name, a period (.), and press the Enter key. When the field name is 
specified this way, letters must be specified in uppercase. 


* If you do not know the field name, press the F4 key twice to show the list. 
Example Action: Press the F4 key. 


The Define Text Detail display appears. 


‘a Define Text Detail > 


Mark: *T003 Measurement method: Row/Column 


Type choices, press Enter. 


Position: 
ACROSS ccsemns set pou sths oreo 13 1-999 
DOWN tes vs) csc ete Remtu nes ace 3 1-999 
Textdatay 27s 4) fain ae ce cc 
F4 for list 
EV@Mmenit “se. cscs vy ee sh ve ee tak oe Name 
EO Gildis aie tues crutch ames caecune i 1=Horizontal, 2=Vertical 
Degree of rotation. .... 0 0, 90, 180, 270 
Colors <nveace seen ee ee tens *DEFAULT *DEFAULT, 1=Blue, 2=Red 
3=Magenta, 4=Green, 5=Cyan 
6=Yellow, 7=Brown, 8=Black 
UgeviWe® 2: sc \w. oe ek we N Y=Yes, N=No 


More... 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method 
F1Q=Edit numeric F12=Cancel 


Text data not specified. 


| 


You can specify all parameters for a text element on the Define Text Detail display. 


Note: You can see the Define Detail display by pressing the F4 key for any 
element as well as text elements. 


Example Action: Move the cursor to the Text data prompt and press the F4 key. 


The Select Field in Record Format display appears. 
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Select Field in Record Format ») 
Database: file: 4. se 3 8 QAFCPFDDTA 
[SIDA cae sn fo eoreesoeomredererss 0: QGPL 
Record: Format. =. . 2. 4.40% PRODMASTER 
Type option, press Enter. 
1=Select 
Opt Field Length Type Text 
1 NAME 15 Product name 
CODE 8 C Product code 
NATION 15 C The country name developed 
PRICE 3,0 P Product price 
AMOUNT 4,0 P Amount of stock 
Bottom 
F5=Refresh Fl1l=Select reserved variable  F12=Cancel ) 


You can select the field in a record format by typing a 1 (Select) in the Opt column. 


Example Actions: 


1. 
2. 


Type 1 in the Opt column beside NAME. 
Press the Enter key. 


The Define Text Detail display appears again with the selected field name in the 
Text data prompt. 


- Define Text Detail a 
Mark:  ¥*T003 Measurement method: Row/Column 
Type choices, press Enter. 
Position: 
ACOSS ese cscdnee cues sueeee 13 1-999 
DOWN reser mewetancuneeesies yee? 3, 1-999 
TOXt data age Soe ce es en ces 
F4 for list 
EVement isos. cs: ce ee fee a vce Name 
Bovimaits <0 ce ues ecUeselsaued Ge ie cwetne 1 1=Horizontal, 2=Vertical 
Degree of rotation. .... 0 0, 90, 180, 270 
GOMOraa ste ceneunt on stcor cannes *DEFAULT *DEFAULT, 1=Blue, 2=Red 
3=Magenta, 4=Green, 5=Cyan 
6=Yellow, 7=Brown, 8=Black 
UnderWines yea: waite ce shes os N Y=Yes, N=No 
OVersitrikes.omy aba soc ise Character 
More... 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method 
F10=Edit numeric F12=Cancel 
Ne a7 
Chapter 8. Getting Started with Print Format Utility 117 


In this case &NAME. is displayed because NAME is the selected field. 
Example Action: Press the Enter key. 


The following display appears. 


A 


Design Record Layout Columns: 1- 74 

Control «. PED: definition) <1. 3 <- PRODUCTLBL 

Be saratiate anes Leenerareite sc ore’Csanasesettaretc soo ianeicvart sisrats Gl encswie Tie eve te O ister aie Tesrstete Oncnsrsiesiaae:cactiestater 
001 
002 
003 »*T001 t : *T003 
004 
005 *T002 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


S 


The variable data is defined as a text element, and a mark *T003 that indicates a 
text element is displayed at the position of the specified variable record. 


Example Action: In the same way, specify another variable text element which 
contains the data in the PRICE field in the record. 


Note: You can concatenate variable data and fixed data by typing in the Text data 
prompt as follows: 


Price : &PRICE. 
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Specifying a Page Segment 


You can specify an image in a record in the following process. 


Example Action: Move the cursor to the position (Across : 25, Down : 6) where you 


want to place the image in the display, and press the F13 key. 
a Design Record Layout Columns: 1- 74 ) 
Control =. . PED) definition ws <2 « < PRODUCTLBL 
Aare te ecatenepstere: taeyerans 2 cnetere Hie sere tet uate ere cteatc nes aicreecet mene eonier eck roms Ole selene sesso eeat evccers 
001 
002 
003 ¥*TO01 t : *T003 


005 *T002 : *T004 . 


f<>] 
[<>] 
an 
ow 


More... 
F3=Exit F6=Place graphics F9=Place page segment  F12=Cancel 
F24=More keys 
Press F6 or F9 to place graphics or page segment. 


BS _ 


A % appears at the cursor position, and the message prompts you to press F6 or F9 
to place graphics or page segment. 


Example Action: Press the F9 key. 


The key entry area appears on the lower part of the display. 
‘a Design Record Layout Columns: 1- 74 . 
Control .. PED. definition .«< . . PRODUCTLBL 
Hicie so tet cre dcsaers Hose sre Creveresert cecal Giaisserestivtepors hese ehhevene sO weiss tietovs al Disserwsetiw we veil orenere 
001 
002 
003 *TO01 t : *T003 
004 
005 *T002 : *T004 . 
006 %S005 
007 
008 
009 
010 
011 
012 


More... 
Place Page Segment 
Mavikstsseco ens arnpee cs 20005: Measurement method . . . . : Row/Column 
POSTtUON sae ess. Across 25 Down 6 
Page Segment . . . QFCLOGO Name 


F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 
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Example Actions: 
1. Type QFCLOGO in the Page segment prompt. 
2. Press the Enter key. 


Note: See 


4 for page segment restrictions. 


The display changes as follows. 
ie Design Record Layout Columns: 1- 74 *) 

Control .s..: PFD definition. .... PRODUCTLBL 

Ris lomebiviara gdlacumsche ss selina stews esc ieteavectncuers Ay aie. cchis cum Orngivetestiays ariO stich sierere ccna 

001 

002 

003 *TOO01 t : *T003 

004 

005 *T002 : *T004 . 

006 *S005 

007 

008 

009 

010 

011 

012 

013 

014 

015 

016 

017 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


‘ es 


The image data is defined as a page segment element, and a mark *S005 that 
indicates a page segment element is displayed at the specified position. 


Specifying a Bar Code Element 


You can specify a bar code in the record layout in the following process. 


Example Actions: 

1. Move the cursor to the position (Down : 7, Across : 3) where you want to place 
a bar code in the display. 

2. Press the F11 key. 


The key entry area appears. 
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Design Record Layout Columns: 1- 74 
Control . .. PED definition... « -: PRODUCTLBL 
Woes tiscs sce Uva ethene ed verre tis see D visiecethvewieA wore athesess Ors eerste we clei vat ewe) eres 
001 
002 
003 *T001 t : *T003 
004 
005 *T002 : *TQ04 . 
006 *S005 
007 %C006 
008 
009 
010 
011 
012 
More... 
Define Bar Code 
Markieince ccs tsore : *C006 Measurement method . . . . : Row/Column 
Position 3. soc Across 3 Down i; Bar code type... 1 
Bar code data 
F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 
\ / 


Example Actions: 

1. Type 1 in the Bar code type prompt. 
2. Type in the Bar code data prompt. 
3. Press the Enter key. 


Note: If you do not know the field name, do the following operations: 
1. Type 1 in the Bar code type prompt and press the F4 key. 


2. On the Define Bar Code Detail display, move the cursor to the Bar code data 
prompt and press the F4 key. 


3. On the Select Field in Record Format display, type a 1 in the Opt column beside 
the field you want to select. 


4. Press the Enter key. 

The Define Bar Code Detail display appears. 
5. Press the Enter key twice. 

The Design Record Layout display appears. 
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Design Record Layout Columns: 1- 74 
Control... PFD definition. .... PRODUCTLBL 
Mere a thievsce suse thes od civaere tere vis Sivrsiv'e Peper oA are oie theres Deer v ene tare ers Oiepavere Pace ei vczie. 


003 *TOO1 t : *T003 


005 «1002 : *T004 . 
006 *$005 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


Ss 7 


The bar code which is created from the specified field in the database file record is 
defined, and a mark *C006 that indicates a bar code element is displayed. 


Specifying a Box Element 
You can draw a box in the record layout. 


Example Action: Move the cursor to the position (Across : 1, Down : 1) of a corner 
of the box and press the F10 key. 


An element mark %B007 appears at the position, and a message prompts you to 


press the F10 key again. 
(~ Design Record Layout Columns: 1- 74 > 
Control) os. PFD definition. .... PRODUCTLBL 


001 %BO07 
002 
003 *TOO01 t : *T003 


005 *T002 : *T004 . 
006 *$005 
007 + *C006 


016 
017 
More... 
F3=Exit F5=Refresh F10=Box F12=Cancel 
F15=Mark on/off F16=Hide F19=Left F2Q=Right 
Specify opposite corner of box and press F10. 
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Example Action: Move the cursor to the position (Across : 35, Down : 9) of the 
opposite corner of the box and press the F10 key. 


A box is drawn in the image area and the key entry area appears on the lower part 


of the display. 
‘a Design Record Layout Columns: 1- 74 ) 
Control «... PED definition « << « PRODUCTLBL 
arene te aerated aveqere tise areiecusteribieyoncte 3 yzpoztes teeters aicrevcrt mtenehl) eoee eck mromss ol Olecteve sheage peat eevsers 
001 %BQ07 ---------------------------- + 
002 : p 


003 : 


*TOO1 t : 


: «7002 


: *C006 


*T003 


: *T004 . 


*$005 


More... 
Define Box 
Makes ve csae esos : *BQO7 Measurement method . . . . : Row/Column 
Start position . . Across 1 Down 1 
End position . . . Across 35 Down 9 


F3=Exit F4=Detail 
F12=Cancel F24=More keys 


F6=Change measurement method 


Example Action: Press the Enter key to define the box element in the record layout. 


The following display appears. 


ce 


a Design Record Layout Columns: 1- 74 S) 
Control .. PFD definition. .... PRODUCTLBL 
Me anaac at eieture Wocaieroctintet sue 2 snavezertiavereraaierereto ti stevereie iovevattootaleisp sscionectistonces Olsraverecttoveretatleenansre 
001 *BQQ7 ---------------------------- + 
002 : E 
003 : *T001 t : *T003 
004 : 
005 : *T002 : *TQ04 . 
006 : *S005 : 
007 : *C006 : 
008 : . 
009 +--------------------------------- + 
010 
011 
012 
013 
014 
015 
016 
017 
More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


o 


Element Selection 

Element selection provides a way to selectively print fields within a record layout. 
If no conditions are specified for element selection, the element is printed each 
time the record layout is printed. You can specify up to five logical conditions to 
select elements. The print format utility compares the contents of the specified 
fields of each record with the specified values and prints the element only for 
those records for which the test results are true. 
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Example Action: 


1. Move the cursor to the position (Across : 13, Down : 5) to change text element 
TO04. 


2. Press the F14 key. 
In the key entry area, press the F9 key. 


4. On the Specify Element Selection display, type NATION under Field, type NE 
under Test, and type RUSSIA’ under Value. 


wo 


The resulting display appears: 
és 2 


Specify Element Selection 
Type choices, press Enter. 
Tests: EQ, NE, LE, GE, LT, GT, RANGE 
AND/OR Field Test Value (Field, number, or 'characters') 
F4 for list F4 for list 
NATION NEL "RUSSIA' 
F3=Exit F4=Prompt F5=Refresh F12=Cancel 
Ne a 


Example Action: Press the Enter key. 


When the data is printed, the PRICE field in each record will be printed only for 
those records in which the NATION field is not ‘RUSSIA’. Because the NATION 
field in each record is a nation other than Russia, the PRICE field will be printed 
for each record. 
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Specifying a Line Element 
You can draw a line in a record layout. 


Example Action: Move the cursor to the position (Across : 3, Down : 4) to start the 
line and press the F9 key. 


An element mark %L008 appears, and a message prompts you to press the F9 key. 


‘a Design Record Layout Columns: 1- 74 fe 
Control PED definition = < . « PRODUCTLBL 
Manaecatereture: Wicca ie estintctave anetere tievetarsiereretetusteverslis isteactectaleuc) sscronests stoners Olsra reves overet ale eaanses 
001 *BQQ7 ---------------------------- + 
002 : . 
003 : *T001 t : *T003 
004 : %L008 
005 : *T002 : *TQ04 . 
006 : *S005 
007 : *C006 
008 : 
009 +--------------------------------- + 
010 
011 
012 
013 
014 
015 
016 
017 
More... 
F3=Exit F5=Refresh F9=Line F12=Cancel 
Fl5=Mark on/off F16=Hide F19=Left F2Q=Right 
Specify opposite end of line and press F9. 
Ne ay 


Example Action: Move the cursor to the end position (Across : 33, Down : 4) of the 


line and press the F9 key. 


A line is drawn in the image area, and the key entry area appears on the lower 


part of the display. 


a Design Record Layout Columns: 1- 74 a 
Control PFD definition <5 2. . PRODUCTLBL 
overs tiereteres Uisisuesethisteuoitel2reueieusPorsisin Sielereiorh nessa aieve sche alae Din scale tinal evel OjsversusPieuese et scsiace 
001 *BQQ7 ---------------------------- a 
002 : 
003 : *T001 t : *T003 
004 : %L008 ------------------------- 
005 : *T002 *T004 
006 : *S005 
007 : *C006 
008 : 
009 +--------------------------------- os 
010 
011 
012 
More... 
Define Line 
Marske 22s tes wee : *L008 Measurement method . . . . : Row/Column 
Start position . . Across 3 Down 4 
End position . . . Across 33 Down 4 
F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 
XE 7 
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Example Action: Press the Enter key. 


The line is defined. 


Example Action: Define another line element from (Across : 3, Down : 6) to (Across 
: 15, Down : 6) in the same way. 


The following display appears. 


( Design Record Layout Columns: 1- 74 > 
Control PFD definition. .... PRODUCTLBL 
Mrasce ach eyeveter las: anecortisyeravee orarass toretee  Oieieverettisvavere Al occtoredt agsieseOserorsvestuaverete| cre aredhiars csi? shavers 
001 *BQQ7 ---------------------------- Re 
002 : : 
003 : *T001 t : *T003 
004 : *L008 ------------------------- 
005 : *T002 *T004 
006 : *LO09 ------- *S005 
007 : *C006 
008 : 
009 +--------------------------------- ae 
010 
011 
012 
013 
014 
015 
016 
017 
More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 
A= = 


Exiting from Design Record Layout 
Example Action: When you have specified all elements in the record layout, press 
the F3 key to exit from this display. 


The Design Page Layout display appears. 


Designing a Page Layout 


On the Design Page Layout display, you can define how the record layout is 
printed on a page, and how other elements such as text and lines, are printed on 


the page. 


Other than the sample in this chapter, you can also define reserved variable data 
such as date, time, page number, and summary data of field values in a database 
for more 


file. See 
information. 
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Design Page Layout Columns: 1- 74 
Control. .. PED definition... 3. PRODUCTLBL 
Wotoa tives sce beceeothes ced eerrets seve d visieiethy erste A ore atheseu Ors wane thew clave vat ewe) «eres 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


XX 


Initially, nothing is defined in the page layout shown above. Place the record 


layout and define fixed data in the page interactively. You can define fixed data in 


the same way you did while designing the record layout. 
You can place the record layout in the following steps. 


Example Action: Move the cursor to the position (Across : 5, Down : 5) you want 
to place the record layout and press the F13 key. 


(a Design Page Layout Columns: 1- 74 


Control .. PFDMderinition: 3.5. 0 40 PRODUCTLBL 
Misi cca sHlesonereileveusrschiecaus(ed euevenort eraletet cierstertisvavs rm Gberevarech sreveve wis euete tisvecaval Ojsiorslcct avevnvel i sdevers 

001 

002 

003 

004 

005 % 

006 

007 


More... 
F3=Exit F6=Place graphics F9=Place page segment 

Fll=Place record layout F12=Cancel F24=More keys 

Press F6, F9 or F1l for graphics, page segment or record layout. 


S 


> 


A percent sign (%) displays to indicate the cursor position. (A mark is not 
displayed because the element type has not yet been specified.) 


The function key area changes and F1l=Place record layout is displayed. 


Chapter 8. Getting Started with Print Format Utility 127 


Example Action: Press the F11 key to place a record. 
a Design Page Layout Columns: 1- 74 >) 
Control .. PED definition) = cs + -: PRODUCTLBL 


001 
002 


005 %ROO1-001 


More... 
Place Record Layout 
Maikets ee ee tents AROOL Measurement method . . . . : Row/Column 
POSiGON &. % 2 Ans Across 5 Down 5 


F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 


sc 7 


A mark %R001-001 is displayed at the cursor position in the image area and the key 
entry area appears at the bottom portion of the display. 


The mark for the record layout has a trailing sequence number. This sequence 
number will be incremented by 1 such as *RO01-002, *RO01-003, and so on, when 
the record layout is repeated. 


Example Action: Move the cursor to the key entry area and press the F4 key. 


The Place Record Layout Detail display appears. 
( “ 


Place Record Layout Detail 


Mark: *ROO1 Measurement method: Row/Column 


Type choices, press Enter. 


Position: 
ACROSS Mees tee rec ye eee eee ears 5 1-999 
DOWN ecgbciee acs mtty bor eotea aca cans ate 5 1-999 
EsM@Mmenit;. csv seassesutemenwen we cess os Name 
Dare Gtiont YF ies i tate ee ce ee ee 1 1=Across, 2=Down 
Repetition: 
AGCGOSSHcy ac otsumce ce pea emcees 2 1-99 
DOWNS 6. Ss Wa 4 1-99 
Distance: 
AChOSSicot traecartcccecseror east Kens 40 1-999 
DOWNS fey ey ce oe wee aes fe vas See ton Ss 10 1-999 


Bottom 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method  F12=Cancel 


You can type the desired choices in the detail list. 
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Example Actions: 


1. Type the value of the repetition (Across : 2, Down : 4) of the record layout to be 
printed. 


2. Type the value of the distance (Across : 40, Down : 10) of the record layouts to 
be printed. 


3. Press the Enter key. 


The Design Page Layout display appears. 
i Design Page Layout Columns: 1- 74 >) 

Control . . PED definition... PRODUCTLBL 
Rrcrta tesa: atetlcsgiass Hivsvsste Qictens catia: coe: e Oivisseceticioncue 4 vavce sit stensre eis. sre tisicue is Oscersceltiany vevil wcoere 


005 *ROO1-001 *ROO1-002 


014 
015 *ROQO1-003 *ROO1-004 
016 
017 
More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


\e Zs 


To print a title on the page, do the following. 


Example Actions: 


1. Move the cursor to the position (Across : 33, Down : 2) to define text and press 
the F6 key. The key entry area appears. 


2. Type Product Delivery Labels in the Text data prompt. 
3. Press the Enter key. 


The following display appears. 
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Design Page Layout Columns: 1- 74 
Control... PFD definition. .... PRODUCTLBL 
Meee icvsce Lissa thigs csi crviea tiers ste Sierss-et eens oA are ose tiersea Oe viene tere ers Oieparere Pace sta vczie. 


002 *TQ02 t Delivery Labels 


005 *RO01-001 *ROO1-002 


015 *RO01-003 *ROO1-004 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


SS 7 


Example Action: Press the F3 key to exit from the Design Page Layout display. 


Since you selected Define printout specifications on the Create PFD Definition 
display, the Define Printout Specifications display appears. 


Defining Printout Specifications 
a > 


Define Printout Specifications 
Type choices, press Enter. 
GopaleSaruurarcsuse: tseachtain 2 1-255 
Preiint, Tel ty eo Oe eet Sees *CONTENT *CONTENT, *ABSOLUTE 
Prlinitequailiity <2 eee sees tees *STD *STD, *DRAFT, *NLQ 
DUDMCxXaceacs er cnte k Mera Ne iran seen an N Y=Yes, N=No 
Omit back side page layout. ... WN Y=Yes, N=No 
FOMMiREY PO2 ser iassesse were seme atte: os *STD Character value, *STD 
SOURGE\dMaWEr™ i fase) PS ees 1 1-255, *El, *CUT 
Front side overlay: 
OVErI Ay Sectacesmreicn cs serene uate 3s *NONE Name, *NONE, F4 for list 
MD Raye eccores pees ee cae sa *LIBL Name, *LIBL, *CURLIB 
Offset: across’ <2 cs S43 Se = - 00 0.00-22.75 
OntSeE “down: sic Ge cieen i, ce ns aston - 00 0.00-22.75 
Back side overlay: 
OVE Aya ceca steers eriicanee geen cs *NONE Name, *NONE, F4 for list 
ibranys 8 covecces) ane occ sles *LIBL Name, *LIBL, *CURLIB 
OffSet dcross: 4. 5. A ee es .00 0.00-22.75 
ORTSERS OWN,” “Pic. cs) Se evince, ceca -00 0.00-22.75 
More... 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel 
XE S/ 


You can specify information such as how many copies are to be printed, which 
form type to use for printing, a different form definition, the overlay for each side 
of the paper, and so on. 


Example Actions: 
1. Type 2 in the Copies prompt. 
2. Press the Page Down key. 


130 AFP Utilities for iSeries: User’s Guide 


A second Define Printout Specifications display appears. 


(- >) 


Define Printout Specifications 
Type choices, press Enter. 
Form Ceninition 26 « Mas ew S * INLINE Name, *DEVD, *INLINE 
IbRays Se cath sehewied cate vo eons Name, *LIBL, *CURLIB 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel 


Specify that the Print Format Utility should create an inline form definition. 


Example Actions: 
1. Type *INLINE in the Form definition prompt. 
2. Press Enter key. 


The Create PFD Definition display appears. 


Exiting from Defining the PFD Definition 
Now you can save the PFD definition and exit from defining a PFD definition. 


fe Create PFD Definition sy 


Elie ters nas mean vel camemeca te :  PFDFILE 

Lei bVay Serpe kcas se sacs eae MYLIB 
PFD definition. ... .. :  PRODUCTLBL 
Type options, press Enter. 

1=Select 
Opt Action 


Define PFD specifications 

Work with PFD definition fonts 
Specify database file 

Specify break fields 

Design record layout 

Design page layout 

Specify record selection 
Define printout specifications 
Specify mapping object name 


F3=Exit F5=Refresh F9=Select all 
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Example Action: Press the F3 key to exit from creating a PFD definition. 


(— Exit PFD Definition 
Type choices, press Enter. 

Option.” Ao tates so de sermannan cen petro sees 1 l=Save and exit 
2=Exit without saving 
3=Resume PFU session 

Return to PFD definition list. . y Y=Yes, N=No 

F12=Cancel 


\ 


Example Actions: 
1. Type 1 in the Option prompt. 
2. Press the Enter key. 


The Save PFD Definition display appears. 


‘c Save PFD Definition 


Type choices, press Enter. 


REDS deiiMaCiOni virco ne) eh cts se eas PRODUCTLBL Name, F4 for list 

FAs a rete eaten once: hose eed Serge eee PFOFILE Name, F4 for list 
[SID Ra Veg sete ce seats ee etc ccucte sete MYLIB Name, *CURLIB 

Text. descriptions <0 4 2 6 einen ee PFD exercise 

Delete removed elements ...... N Y=Yes, N=No 


F4=Prompt F5=Refresh  F12=Cancel 
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Example Action: Type PFD exercise in the Text ‘description’ prompt, and press the 
Enter key. 


The following display appears. 
a » 


Work with PFD Definitions 


Pile ccc a is ee PFDFILE Name, F4 for list 
[IDNR a eoesesee ees setae. MYLIB Name, *LIBL, *CURLIB 

PED detinmitaion- <4 3.4) 3 *ALL Name, generic*, *ALL 

PoSittion tons mcs i es Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 6=Print PFD definition 7=Rename 
9=Print database file 


PFD 
Opt Definition Text Changed 
9  PRODUCTLBL 

PRODUCTLBL PFD exercise 12/13/90 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 
F12=Cancel 


a PFD definition PRODUCTLBL saved in file PFDFILE successfully. J 


From this display, you can print a database file. 
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Step 4 - Printing a Database File 


You can print a database file in the following procedures. 


Example Actions: 
1. Type 9 (Print ) in the Opt column beside PRODUCTLBL. 
2. Press the Enter key. 


The Print Database File Member display appears: 
ia > 


Print Database File Member 


FAshevecopees eater eerie suis a PED EME 
BDA rRVeestee eats eae coleee ete MYLIB 
PED definition... «3. ©... «+ ‘PRODUCTLBL 


Type choices, press Enter. 


Database Tiles Sasso ee aes *PFD Name, *PFD, F4 for list 
[SHIDRAYY> sees. eve coh ee ee fen oe ee *LIBL Name, *LIBL, *CURLIB 
MONDE <. aocc weal eo ae ee ee *FIRST Name, *FIRST, F4 for list 
Include grid’. 2.3 sv 4s aes N Y=Yes, N=No 
Record selections.) j= aoe Y=Yes, N=No 
Endjing:page® 4.20 so 2 vec os. eras *END 1-9999, *END 
SOUNCeDrAWeNn™ vz. cae ce: i es es *PFD 1-255, *PFD, *El 
OUT DUES DIN ewe hse nee ae *DEVD 1-65535, *DEVD 
COpPNESit4 ce ea cays coet seer case mea rat se *PFD 1-255, *PFD 
Qutput: queue’< to. Ae use: *JOB Name, *JOB 
EnibMar yrs, ceevsuns csc wie. bene Name, *LIBL, *CURLIB 
More... 


F3=Exit F4=Prompt F5=Refresh  F12=Cancel 


= A 


Example Action: Press the Enter key to use the predefined values. 
The database file member is printed. 


Note: A spooled file is created in an output queue by the print operation, and it is 
printed on the printer after the print writer sends it to a printer. 
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Step 5 - Ending the Print Format Utility 


When the database file is printed, the following display appears: 


(~ Work with PFD Definitions 


FAln@segeuveeem te asenc es eter PPOFILE Name, F4 for list 
[EaID MARY 22 ser eoe ee teres MYLIB Name, *LIBL, *CURLIB 

PED detinition . «+ « *ALL Name, generic*, *ALL 

POSataioni tos eis <a te Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 6=Print PFD definition 7=Rename 
9=Print database file 


PFD 

Opt Definition Text Changed 
PRODUCTLBL 
PRODUCTLBL PFD exercise 12/13/90 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 
F12=Cancel 
Member QAFCPFDDTA in database file QAFCPFDDTA printed. 


S 


Example Action: Press the F3 key to end the Work with PFD Definitions display. 


The Work with PFD Definition Files display appears. 


( Work with PFD Definition Files 
brary: <5: Ge wes. es eS MYLIB Name, *USRLIBL, *LIBL, *CURLIB... 
PGs We ee be et Re cee ee *ALL Name, generic*, *ALL 
POSTION tO. Seteer ae Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 7=Rename 8=Display description 
12=Work with PFD definitions 


Opt File Library Text Changed 
PFDFILE MYLIB 
PFDFILE MYLIB PFD file for exercise 12/13/90 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve  F1l=Display names only 
F12=Cancel 
PFD definition file PFDFILE created in library MYLIB. 


Example Action: Press the F3 key. 


The IBM Advanced Function Printing Utilities for iSeries menu appears. 
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IBM Advanced Function Printing Utilities for iSeries 
Select one of the following: 


Overlay Utility 
1. Work with source overlays 
2. Work with source overlay files 


Print Format Utility 
11. Work with PFD definitions 
12. Work with PFD definition files 
13. Print database file member 
14. Print AFP Utilities tutorial 


Resource Management Utility 
21. Convert to page segment 
22. Work with overlays 
23. Work with page segments 


Selection or command 


===> 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F16=System main menu 
S. 4 


Step 6 - Printing the AFP Utilities tutorial 


A tutorial or a part of the tutorial which explains IBM Advanced. Function Printing 
Utilities for iSeries functions and gives additional examples can be printed by 
using option 14 on the IBM Advanced Function Printing Utilities for iSeries menu. 


Example Actions: 
1. Type 14 (Print AFP Utilities tutorial) on the Selection or command line. 
2. Press the Enter key. 


The Print Database File Member display appears: 
(— a) 


Print Database File Member 
Type choices, press Enter. 
FEC coc ata egestas eee oe QAFCTUTPFD Name, F4 for list 
Mibranya Cae erepene secocere ae QGPL Name, *LIBL, *CURLIB 
PFO etiam tine soe. Go ate TUTORIAL Name, *FIRST, F4 for list 
Database Tile 2 <4 « ee 4s *PFD Name, *PFD, F4 for list 
[IID aVVew en scarecpenees eeicon ere rcay: *LIBL Name, *LIBL, *CURLIB 
MEMDGIG isi crus se) ates el nee ce alee *FIRST Name, *FIRST, F4 for list 
TNGillUd eG irildlnseccret sues perce ase ve N Y=Yes, N=No 
Record selection’ =. 2... 8 us ue c Y=Yes, N=No 
Ending, page: =< 4.0% YB was *END 1-9999, *END 
SOURCEMD AWE. sores -Saesimer cen cece *PFD 1-255, *PFD, *El 
QUE D UIE. DiliIne se cetesr ne oy tues es sles *DEVD 1-65535, *DEVD 
GOPIGS) 6. sen ce: Men wes oe ee ces ie ose es *PFD 1-255, *PFD 
Output: queue’... ss a ee ee *JOB Name, *JOB 
LID Rayer ant aeseren creer toon Pee Name, *LIBL, *CURLIB 
More... 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel 
\ yy 
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To print only the tutorial overview. 


Example Actions: 
1. Press the Tab key twice to position the cursor to the PFD definition prompt. 
2. Press the F4 key. 


The Select PFD Definition display appears: 


fe Select PFD Definition ) 


FAC Serr ep toes Gu see eee SOAR CRUTPRED 
[EVibrdiey? ee ecarates eas QGPL 
POSTETON LO ie, a Steet Starting characters 


Type option, press Enter. 


1=Select 

PFD 

Opt Definition Text 
TUTORIAL Entire tutorial 
TUTOR10 Overview - Topics covered in the tutorial 
TUTOR20 Create Source Overlay file and Source Overlay 
TUTOR25 Create Source Overlay 
TUTOR30 Create the database file and add data with DFU 
TUTOR32 Create the database file - no data 
TUTOR40 Add data to the database file with DFU 
TUTOR50 Create PFD File, Create and Change a PFD 
TUTOR55 Create a PFD Definition 

More... 
F5=Refresh  F12=Cancel 
SS a 


Example Actions: 
1. Press the Tab key to position the cursor to PFD definition TUTOR10. 
2. Type 1, and press Enter. 


The Print Database File Member display appears again. 


Example Action: 
1. Press the Enter key again to print the tutorial overview. 


Note: A spooled file is created in an output queue by the print operation, and it is 
printed on the printer after the print writer sends it to a printer. 


The IBM Advanced Function Printing Utilities for iSeries menu appears. 


Example Action: Press the F3 key to return to the Main Menu. 
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Chapter 9. Starting and Ending the Print Format Utility 


This chapter provides additional information for starting and ending the Print 


Format Utility. 


Starting the Print Format Utility 


You can start the Print Format Utility by typing either of the following commands 
on the command line and pressing Enter. 


1. STRAFPU (Start IBM Advanced Function Printing Utilities for iSeries) 
2. STRPFU (Start Print Format Utility) 


If you start by typing STRAFPU, the following menu appears: 


‘a AFPU 


21 
22% 


===> 


F3=Exit 


You can start the following four Print Format Utility functions from this menu: 


Option 
11 
12 
13 
14 


IBM Advanced Function Printing Utilities for iSeries 


Select one of the following: 


Overlay Utility 
. Work with source overlays 
. Work with source overlay files 


Format Utility 


. Work with PFD definitions 

. Work with PFD definition files 
. Print database file member 

. Print AFP Utilities tutorial 


Resource Management Utility 


Convert to page segment 
Work with overlays 


23. Work with page segments 


Selection or command 


F4=Prompt F9=Retrieve  F12=Cancel Fl6=System main menu 


(C) COPYRIGHT IBM CORP. 1991, 1993. 


Function 

Work with PFD definitions 
Work with PFD definition files 
Print database file member 
Print AFP Utilities tutorial 


The following describe the options available on the above menu. To select one of 
the following, type the number of the option on the command line, and press 


Enter. 
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Option 11 (Work with PFD definitions) 


Work with PFD definitions allows you to do the following: 


* Create a PFD definition. You can start this option by specifying the name of a 
PFD definition name with the option number. 


* Change a PFD definition. 
* Copy a PFD definition. 

* Delete a PFD definition. 
¢ Print a PFD definition. 


* Rename a PFD definition. 
¢ Print a database file. 


for more information. 


Option 12 (Work with PFD definition files) 


Work with PFD definition files allows you to do the following: 


* Create a PFD definition by specifying the name of a library, a PFD definition file 
name, and the option number. 


* Change the description of a PFD definition file. 
* Copy a PFD definition file. 

* Delete a PFD definition file. 

* Rename a PFD definition. 

* Display the description of a PFD definition file. 
* Call the Work with PFD Definitions display. 


03] for more 


information. 


Option 13 (Print Database File Member) 


Print database file member allows you to create a printing request interactively to 
the system by specifying a PFD definition, a database file, an output queue, and 
other information to print a database file member. See Chapter 12. Print Databasd 


5 for more information. 


If you start the Print Format Utility by_using the STRPFU command, the Work 
with PFD Definitions display on page had appears. You can skip the Work with 
PFD Definition display by specifying a PFD definition name and an option number 
with the command. 


See hapte 2 a 4 for more 
information. 


Option 14 (Print AFP Utilities tutorial) 


Print AFP Utilities tutorial allows you to print the full tutorial or part of the 
tutorial. The Print Database File Member display appears. The values provided can 
be changed to specify the number of copies or to direct the output to a different 
output queue. To print the entire tutorial, press the Enter key. To print only part of 
the tutorial, place the cursor at the PFD definition prompt and press F4. The select 
PFD definition display will appear where you can select the section of the tutorial 
you want to print. The sections from which you can choose are: 


¢ Entire tutorial 
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* Overview - Topics covered in the tutorial 

* Create Source Overlay file and Source Overlay 

* Create Source Overlay 

* Create the database file and add data with DFU 

* Create the database file - no data 

* Add data to the database file with DFU 

* Create PFD File, Create and Change a PFD 

* Create a PFD Definition 

* Change a PFD Definition 

¢ Print PFD Data 

* Copy a PFD Definition 

* Convert a page segment to a physical file member 
* Convert a physical file member to a page segment 


Ending the Print Format Utility 


When you complete the work with the Print Format Utility, press the F3 key 
repeatedly. If you start the Print Format Utility by using the STRAFPU command, 
the menu panel display appears on page 


If you start the Print Format Utility by using the STRPFU command, the menu 
panel display on page 43] appears. 


To end the Print Format Utility, press the F3 key one more time. Then the screen 
returns to the display from which you started the Print Format Utility. 
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Chapter 10. Work with PFD Definitions 


This chapter provides additional information for working with PFD definitions. 


You can select the following options from this display. 
* Creating PFD definition 

* Changing PFD definition 

* Copying PFD definition 

* Deleting PFD definition 

* Printing PFD definition 

* Renaming PFD definition 

* Printing database file 


Select 11 (Work with PFD definitions) on the AFP utilities menu on page (139, and 
press the Enter key. The following display appears: 


C Work with PFD Definitions >) 


Fue Letras ce aetanen ae eee PFUFILE Name, F4 for list 
[SIDMARVane co seeeeone treet PFULIB Name, *LIBL, *CURLIB 

PED MeTInGtION: x. oe *ALL Name, generic*, *ALL 

POSMtION) tOns us cs es ce Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 6=Print PFD definition 7=Rename 
9=Print database file 


PFD 

Opt Definition Text Changed 
PFD1 Sample PFD definition 12/13/90 
PFD2 Sample PFD definition 12/13/90 
PFD3 Sample PFD definition 12/13/90 
PFD4 Sample PFD definition 12/13/90 

Bottom 

Parameters or command 

===> 

F3=Exit F4=Prompt F5=Refresh F9=Retrieve  F1l=Display names only 

F12=Cancel 

Se eA 


When the definition is the first PFD definition to be created, no definition list 
appears on the display. 


Note: Before you create a PFD definition, you need to create a PFD definition file 
by using option 1 (Create) on the Work with PFD Definition Files display. 


The following tables explain the Work with PFD Definitions display. 
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Prompts 


Table 18. Work with PFD Definitions prompts 


Prompt 
File 


Library 


PFD definition 


Position to 


Description 


Specifies the PFD definition file that contains the PFD definitions you 
want to list and work with. 


Press F4 to go to a selection list of PFD definition files in the specified 
library. 

Specifies the name of the library that contains the PFD definition file 
containing the PFD definitions you want to work with. The possible 
library values in this field are: 


*LIBL To specify the file containing the PFD definitions you want to 
work with is in one of the libraries in the library list. 


*CURLIB 
To specify that the file containing the PFD definitions you want 
to work with is the current library. If no library is specified as 
the current library for the job, library QGPL is used. 


library-name 
Specifies the name of the library that contains the file 
containing the PFD definitions you want to work with. 
Specifies that you want to work with all the PFD definitions in the file 
or a subset of the PFD definitions in the file. Choose from the following: 


PFD definition name 
Specifies a PFD definition name for a display with only that 
PFD definition name in the list. 


generic name 
Specifies a partial name of the PFD definition name qualified 
by an asterisk (*) to display a specific subset of PFD definitions. 
The generic name is the following format: 


ABC* Displays a list of all PFD definitions that begin with 
the characters ABC. For example, ABC, ABCD, and 
ABCTEST. 


*ALL To display all the PFD definitions in the specified file. 
This prompt is used for quick repositioning of the list, not for creating a 
subset of the list. Choose one of the following: 


*TOP To go to the top of the list. 
*BOT To go to the bottom of the list. 


name or partial name 
Specifies the name or partial name you want to go to in the list. 
The list is positioned to the first name beginning with the string 
specified. 
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Options 


Table 19. Work with PFD Definitions options 


Option 


1=Create 


2=Change 


3=Copy 


4=Delete 


6=Print 


7=Rename 


9=Print 
database file 


Description 
Creates a PFD definition. 


You can create a new PFD definition. Type 1 in the Opt column, and the 
name of the PFD definition you want to create in the first line in the list. 


See 47 for more information. 


Note: Before you create a PFD definition, you need to create a PFD 
definition file by selecting 1 (Create) on the Work with PFD Definition Files 
display. 

Changes a PFD definition. 


You can change a PFD definition and save it with either the same name or 
a new name. That is, you can create a new PFD definition based on an 
existing PFD definition using this option. It is also possible to save the PFD 
definition in a different PFD definition file or in a different library. Type 2 
in the Opt column beside the name of the PFD definition you want to 
change. 


You can copy a PFD definition to another file, another library, or both. Type 
3 in the Opt column beside the name of the PFD definition you want to 


copy. 


You can confirm the choices on the next display before deleting the PFD 
definitions. Type 4 in the Opt column beside the name of the PFD 
definition you want to delete. 


See QO} for more information. 


Prints a PFD definition. 


Specify 6 in the Opt column beside the name of the PFD definition you 
want to print. 


01) for more information. 


Rename a PFD definition. 


Specify 7 in the Opt column beside the name of the PFD definition for 
which you want to change the name. 


01] for more information. 


Prints a database file member. 


You can print a database file member based on the PFD definition. Type 9 
in the Opt column beside the name of the PFD definition on which to base 
the printing of a database file member. 


01) for more information. 
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Columns 


Table 20. Work with PFD Definitions columns 


Column Description 


Opt Specifies the number of the task in the Opt prompt beside the PFD 
definition you want to perform the task with. 


You can type the same option next to more than one PFD definition at a 
time, and you can also type different options next to different PFD 
definitions at the same time. 

PFD definition Shows a list of all the PFD definitions in the specified file that meet the 
subset criteria. You can use the top position in the list to type a PFD 
definition you want to create or select another option. 

Text The text description of the PFD definition is shown. 

Changed The date of the last change to the PFD definition is shown. 


Showing a PFD Definition List 


The PFD definitions can be listed on the lower part of the display by specifying 
the Library prompt and File prompt. When you want to change the content of the 
list, specify the name of a file and library, and press the Enter key. You can page 
up or down the list on the display by specifying the starting characters in the 
Position to prompt. 


Note: When you specify any of the PFD Definition prompt, File prompt, and 
Library prompt, you can not specify the Opt column. 


Selecting a PFD Definition from a List 


The list on the display contains the names of all or specified subset of the PFD 
definitions that exist in the PFD definition file indicated by the File prompt. The 
text that describes the PFD definitions and the date of the last change to the PFD 
definition are also shown in the list. 


When a list is shown, a one-word indicator always appears below and to the right 
of the list to tell you where you are in the list. More... means that there are more 
items after the item currently shown. Bottom means that you are at the end of the 
list. 


Use the Page or Roll keys to move forward or backward through the list. 


If you are creating a PFD definition, you can check this list to see what names are 
already used before you choose a new name. You can create a PFD definition by 
typing 1 and a PFD definition name in the first list position, and you can select 
other PFD definitions from the list using any of the options except 1 (Create). 


Therefore, you can select one or more names by doing one or both of the 

following: 

* In the Opt column beside the PFD definition name in the list that you want to 
use, type the number of the option (task) to be used. 

* In only the first (top) position of the list, type an option number (for the task), 
and a PFD definition name in the Opt and PFD Definition columns respectively. 
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Note: You can create a PFD definition by specifying the new PFD definition name 


on this display, but you can not create a PFD definition file from this 


display. Use the Work with PFD Definition Files display to create a PFD 


definition file. If you do not have a library for the PFD definition file, use 


the Create Library (CRTLIB) command to create a library. 


1=Create PFD Definitions 
To create a PFD definition, do the following on the display on page f4al 


1. 
2. 


3. 


Type 1 in the Opt column in the first line of the list. 


Type the PFD definition name in the PFD definition column in the first line of 


the list. 
Press the Enter key. 


The following display appears. 


XX 


Create PFD Definition 


FAMCm Speer euteteacuntancda sta tunemes PFUFILE 
[EAIDYAIV? tome eee e cease oocere PFULIB 
PED ede taim@t nomi eee: fo ers 38 PFDNEW 


Type options, press Enter. 
1=Select 

Opt Action 

Define PFD specifications 

Work with PFD definition fonts 


1 Specify database file 

Specify break fields 
1 Design record layout 
1 Design page layout 


Specify record selection 
Define printout specifications 
Specify mapping object name 


F3=Exit F5=Refresh F9=Select all F12=Cancel 


a AE ee a 


From the Create PFD Definition display, you can select one or more of the 
following actions to define a PFD definition. 


Define PFD specifications 
Work with PFD definition fonts 
Specify database file 

Specify break fields 

Design record layout 

Design page layout 

Specify record selection 

Define printout specifications 


Specify mapping object name 
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The following table explains each field of the Create PFD Definition display. 


Table 21. Create PFD Definition display fields 


Field Name 


Description 


File 
Library 


PFD definition 


1=Select 


Opt 


Action 


Shows the PFD definition file name which you specified. 

The name of the library in which the PFD definition file resides is 
shown. 

The name of the PFD definition that you specified on the previous 
display is shown. 

Allows you to select one or more actions from the list. 

Specify 1 (Select) in the Opt column beside the actions you want to 
select. 

You can select one, some, or all of the following actions for PFD 
definition. 


Define PFD specifications 
Allows you to define specifications of the printout format, 
such as characters per inch, lines per inch, size (width and 
length), and so on. 


Work with PFD definition fonts 
Allows you to change fonts you use to print. 


Specify database file 
Allows you to specify the database file to print. 


Specify break fields 
Allows you to select the fields which cause the page break. 


Design record layout 
Allows you to define where the fields of the record in the 
database file are placed in the record layout. The values in 
the specified fields are printed as text, page segments, 
graphics, or bar codes (variable data). It also allows you to 
place variable data such as job date, job time, page number, 
record number, database file name, library name, and 
member name (reserved variable data) in the record layout. 


It also allows you to define where the fixed data, such as 
text, bar codes, lines, boxes, page segments, and graphics 
are placed in the record layout. 


Design page layout 
Allows you to specify how to print a record repeatedly on a 
page. It also allows you to define where the variable data 
such as job date, job time, page number, record number, 
database file name, library name, and member name 
(reserved variable data) are placed on a page. 


It also allows you to print the variable data such as the field 
value of the first record in the group, the field value of the 
last record in the group, the total of the field values in the 
group, the average of the field values in the group, the 
maximum field value in the group, the minimum field 
value in the group, and the record counts of the group 
(summary data). 


It also allows you to define the fixed data, such as text, bar 
codes, lines, boxes, page segments, and graphics on a page. 
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Table 21. Create PFD Definition display fields (continued) 


Field Name Description 


Action : . 
. Specify record selection 


Allows you to select records based on the comparative 
condition that you specify, such as equal to, greater than, 
less than, and so on. 


Define printout specifications 
Allows you to define how the printout will be printed, such 
as: 


¢ Number of copies 

° Print quality 

* Source drawer 

* Form type 

* Form definition 
Specify mapping object name 


Allows you to specify the mapping between the database 
field value and the object name. 


The selected options are performed one after another, and this display appears 
again when all operations are completed. 


Specify 1 in the Opt column beside the action you want to select. 
If you want to select all actions, press F9. 


When you have completed all operations, press F3 to exit this display. 


Define PFD Specifications 
a S 


Define PFD Specifications 


Type choices, press Enter. 


Printer type: «se cas vec cs ws as *DEFAULT  *DEFAULT, 1 - 9999 

Characters per inch .... 10.00 5.00, 10.00, 12.00, 13.30, 15.00 
16.70, 18.00, 20.00 

EINes.per tnchics sekce co es as 6.00 3.00, 4.00, 6.00, 7.50, 8.00, 9.00 
12.00 

Degree of rotation. .... 0 0, 90, 180, 270 

Page number 3 3 ce ws N Y=Yes, N=No 

DBCS. 'SO/SI ‘spacing. ...... if Y=Yes, N=No 


More... 
F3=Exit F5=Refresh  F12=Cancel 


x - 
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Define PFD Specifications 
Type choices, press Enter. 
Unit of measure ...... il 1l=Inch, 2=Centimeter 
Data: element... 2. 3c. &. 44s 1 l=Inch, 2=Centimeter 
Measurement method. ... I 1=Row/Column, 2=Inch/Centimeter 
Size: 
Measurement method. ... 1 1=Row/Column, 2=Inch/Centimeter 
Widths wesc a wueemecwtr ass tens 80 1-999 
Heights 2 awe es 60 1-999 
Offset 
Measurement method. ... 1 1=Row/Column, 2=Inch/Centimeter 
ACROSS Meitet on es sees ae eee ce 0 0-999 
DOWNikcreegucceseeryer enh tae sn see 0 0-999 
Grid: 
Measurement method. ... 1 1=Row/Column, 2=Inch/Centimeter 
ACROSS ce seas cmt poate twscnceane 10 1-999 
DOWN tenverustxecceemel orinesunece 6 1-999 
Bottom 
F3=Exit F5=Refresh F12=Cancel 


SS 


The Define PFD Specifications display allows you to define PFD specifications, 
such as printer type, characters per inch, lines per inch, page size, and degree of 
rotation. 
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The following table explains each field of the Define PFD Specifications display. 


Table 22. Define PFD Specifications display fields 


Field Name 


Description 


Printer type 


Characters per inch 


Specifies the printer type you are going to use. You can use 1, 2, 3, 4, 
5, 6, 7 and 9 for printer type. These values previously supported, and 
will continue to support, the following printer types: 


1 4224, 4234, 4230 

2 3812, 3816, 3930 

3 3916, 4028 

4 3820, 3825, 3827, 3829, 3835, 3900 

5 3825, 3835, 3900 with the Advanced Function Image and 


Graphics feature 


6 3831 
7 3935 
9 Not specified 


*DEFAULT also means Not specified. If *DEFAULT or 9 is specified, 
the Confirm or Change Printer Attributes screen is displayed to let 
you specify attributes for your printer type. If you know the 
attributes of your printer, but the printer is not supported by the 
current release of, use this screen to specify the attributes. For 
example, if you specify that your printer supports the Bar Code 
Object Content Architecture (BCOCA), the printer data stream for bar 
codes will be created with BCOCA. However, if you specify that your 
printer does not support BCOCA, the bar codes will be created with 
the Presentation Text Object Content Architecture (PTOCA). PTOCA 
bar codes can be printed on any IPDS printer, but BCOCA bar codes 
print much faster. 


Any valid four-digit IBM IPDS printer type may also be specified. 
The field level help for this parameter shows a list of the printers 
supported for each release after Version 3, Release 2. As new printers 
are added and supported, their four-digit type number will be added 
to the list of printers supported. Because this may occur between 
releases, the list may not be complete. 


The specified value is used to: 
* Check if each element is supported by the printer. 


* Create the appropriate data stream for each printer. 


Specifies the number of characters per inch to print. A double-byte 
character is counted as two. You can choose 5.00, 10.00, 12.00, 13.30, 
15.00, 16.70, 18.00 and 20.00 for the CPI. The default value is 10.00. 


This value is used to decide horizontal positions when the 
measurement method is Row/Column. 


This value is used to decide the horizontal positions of the text in the 
box element. 
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Table 22. Define PFD Specifications display fields (continued) 


Field Name 


Description 


Lines per inch 


Unit of measure 


Size 


Measurement 
method 


Width 


Height 


Degree of rotation 


Page number 


DBCS SO/SI spacing 


Offset 


Specifies the number of lines per inch to print. You can choose 3.00, 
4.00, 6.00, 7.50, 8.00, 9.00 and 12.00 for the LPI. The default value is 
6.00. 


This value is used to decide vertical positions when the measurement 
method is Row/Column. 


This value is used to decide the vertical positions of the text in the 
box element. 
Specifies the unit of measure to use: 


1 Row/Column is used as the measurement method. 


2 Either inch or centimeter is used as the measurement method 
depending on the value specified for the unit of measure. 

The page size is defined by the measurement method, the width, and 

the height. 

Specifies the measurement method being used for the size. 


Possible values are: 
1 Row/Column is used as the measurement method. 


2 Either inch or centimeter is used as the measurement method 
depending on the value specified for the unit of measure. 

Note: To change both the measurement method and its following 

fields, change the value for the measurement method and press the 

Enter key before changing the following fields. 

Specifies the horizontal size of the page. The valid values depend on 

the measurement method specified. 

* 1-999 (in columns) 

* 0.10 - 22.75 (in inches) 

* 0.10 - 57.79 (in centimeters) 

Specifies the vertical size of the page. The valid values depend on the 

measurement method specified. 

* 1-999 (in rows) 

* 0.10 - 22.75 (in inches) 

* 0.10 - 57.79 (in centimeters) 

Specifies the number of degrees to rotate the page in the clockwise 

direction. Select 0, 90, 180, or 270 degrees. 

Specify whether or not page numbers are to be printed. Type one of 

the following: 


Y (Yes) Page numbers are printed. 


N (No) Page numbers are not printed. 
Specify Y or N to specify whether shift-out (SO) and shift-in (SI) 
characters are printed as blanks. 


Y (Yes) The shift-out and shift-in characters in the text data are 
printed as blank characters. 


N (No) The shift-out and shift-in characters in the text data are not 
printed. They occupy no space in the printout. 

Note: DBCS SO/SI spacing is valid only when the file is a DBCS 

capable file. 

The offset is the distance between the page origin and the page 

layout, and is defined by the measurement method, the across 

(horizontal distance), and the down (vertical distance) positions. 
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Table 22. Define PFD Specifications display fields (continued) 


Field Name 


Description 


Measurement 
method 


Across 


Down 


Grid 


Measurement 
method 


Across 


Down 


Specifies the measurement method to be used for the offset. 


Possible values are: 
i Row/Column is used as the measurement method. 


2 Either inch or centimeter is used as the measurement method 
depending on the value specified for the unit of measure. 

Note: To change both the measurement method and its following 

fields, change the value for the measurement method and press the 

Enter key before you change the following fields.The following fields 

specify the offset of the page layout. 

Specifies the value of the horizontal distance from the left edge of the 

logical page to the origin of the element to be created. The valid 

values are: 

* 0 to 999 (columns) 

* 0 to 22.75 (inches) 


* 0 to 57.79 (centimeters) 

Specifies the value of the vertical distance from the top edge of the 
logical page to the origin of the element to be created. The valid 
values are: 

* 0 to 999 (rows) 

* 0 to 22.75 (inches) 

* 0 to 57.79 (centimeters) 

The grid is the combination of lines at regular intervals, and is 
defined by the measurement method, the across (horizontal interval), 
and the down (vertical interval). 

Specifies the measurement method being used for the grid. 


Possible values are: 
i Row/Column is used as the measurement method. 


2 Either inch or centimeter is used as the measurement method 

depending on the value specified for the unit of measure. 
Note: To change both the measurement method and its following 
fields, change the value for the measurement method and press the 
Enter key before changing the following fields. 


You can specify to print horizontal and vertical lines with the printout 
to help your designing work. The following fields specify the 
horizontal and vertical distances between grid lines. 

Specifies the value of the horizontal distance from the left edge of the 
logical page to the origin of the element to be created. The valid 
values are: 

* 1-999 (columns) 

* 0.10 - 22.75 (inches) 

* 0.10 - 57.79 (centimeters) 

Specifies the value of the vertical distance from the top edge of the 
logical page to the origin of the element to be created. The valid 
values are: 

* 1-999 (rows) 

* 0.10 - 22.75 (inches) 

* 0.10 - 57.79 (centimeters) 
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Change PFD Specifications 

You can change the specifications of an existing PFD definition, or create a new 
PFD definition based on an existing PFD definition by changing it. Conflicts can 
occur between previously defined elements and changed specifications in the same 
PFD definition. This method is usually preferred in the following cases. 


Note: The change operation is similar to the create operation. The only difference 
is that the previously entered parameters are already filled in for each field 
when the display appears. See De 
the description of each parameter. 


* Making the page size smaller 


When you attempt to reduce the page size from the previously defined value, 
some elements are placed outside of the newly defined page. For example, 
elements placed close to the right edge of the previous page layout or record 
layout can be moved outside of the newly defined page. In this case, elements 
are deleted if their positions are moved out of the page. 


The Print Format Utility displays the confirmation display when such a situation 


specifications operation. See 
information. 


* Changing the unit of measure 


The Print Format Utility allows changing the unit of measure in the PFD 
specifications between inches and centimeters. The defined numbers in each 
element do not change. So some elements are placed outside of the page layout 
or the record layout when the number specified for the size exceeds the possible 
maximum value for the unit. In this case, the page size is made smaller as 
explained earlier. 

* Changing the printer type 
The Print Format Utility allows changing the printer type in the PFD 
specifications. The Print Format Utility checks the compatibility between 
previously defined elements with the newly specified printer type. If the Print 
Format Utility finds any mismatched elements, the Print Format Utility displays 
the confirmation display and lists these elements on the display. You can then 
delete the elements or cancel changing the PFD specifications. 


When the parameter values of the elements become incorrect by changing the 
parameter values of the PFD specifications, a warning message is displayed. You 
can adjust parameter values of those element as follows by pressing the Enter key, 
or you can change the parameter values of the PFD specifications to correct the 
errors. 
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The following table describes the cause of warning messages and the result. 


Table 23. The Cause of Message and Its Result 


Cause 


Result 


The Unit of measure changed from 1=Inch to 2=Centimeter 
and the value for Module width gets too small. For 
example, 0.001 inches becomes 0.001 centimeters. 


The Unit of measure changed from 2=Centimeter to 1=Inch 
and the value for Module width or Line width gets too 
large. For example, 2 centimeters becomes 2 inches. 


The Printer type changed from 1=4224/4234/4230 or 9=Not 
specified to another type and the value for Color 
becomes not correct. For example, 1=Blue is not correct. 


The Printer type changed from another type to 
1=4224/4234/4230 , or 2=3812/3816/3930, or 3=3916/4028 , 
or 7=3935 and the value for Format becomes not correct. 
For example, 2=Vertical is not correct. 


The Printer type changed from 1=4224/4234/4230 , or 
2=3812/3816 , or 3=3916/4028, or 7=3935 , or 9=Not 
specified to another type and the value for Overstrike 
becomes not correct. For example, X is not correct. 


The Printer type changed from 1=4224/4234/4230 , or 
2=3812/3816/3930 , or 3=3916/4028 , or 7=3935 , or 9=Not 
specified to another type and the value for Underline 
becomes not correct. For example, Y is not correct. 


The Printer type changed from 1=4224/4234/4230 , or 
2=3812/3816/3930 , or 3=3916/4028 , or 7=3935 , or 9=Not 
specified to another type and the value for Character size 
becomes not correct. For example, 1 is not correct. 


The correct minimum value 
0.003 centimeter is used. 


The correct maximum value 1 
inch is used. 


The value «DEFAULT is used. 


The value 1=Horizontal is used. 


Blank is used. 


The value N is used. 


The value «DEFAULT is used. 
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Confirm Delete of Elements 
Confirm Delete of Record Layout Elements 


i > 


Confirm Delete of Record Layout Elements 
Press the Enter key to confirm your choices for delete. 
Press F1l2 to return to change your choices. 
Position Position 
Mark Name Across Down Reason 
*S001 LOGO 25 66 Out of page 
*G003 1 1 Out of page 
*L007 3 4 Out of page 
Bottom 
F12=Cancel 
ne 7 


The Confirm Delete of Record Layout Elements display shows the list elements in 
the Record layout to be deleted due to change of the PFD specifications. The 
Reason column shows why the element is to be deleted. 


You can delete these elements by pressing Enter. If you don’t want to delete these 
elements, press F12 to cancel, and the Define PFD Specifications display appears. 


Table 24. Confirm Delete of Record Layout Elements display fields 


Field Name Description 

Mark Shows the element mark. 

Name Shows the element name that is assigned for each element on the 
Create or Change Element Detail display. 

Position Across Shows the horizontal position of the element. 

Position Down Shows the vertical position of the element. 

Reason Shows the reason the element is to be deleted. 
Out of page 


The position of the element is not within the size specified in 
the PFD specifications. 


* If the element is text, bar code, or page segment, its start 
position is outside. 


* If the element is line, box, or graphics, its bottom-right 
corner is outside. 


Not supported by printer type 
This type of element is not supported by the printer type 
specified with the PFD specifications. 


If the element is graphics, the printer does not support the 
function to print graphics. 
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Confirm Delete of Page Layout Elements 
i > 


Confirm Delete of Page Layout Elements 
Press the Enter key to confirm your choices. 
Press Fl2 to return to change your choices. 
Position Position 
Mark Name Across Down Reason 
*BOO1 5 5 Out of page 
*T003 88 2 Out of page 
*GO11 27 10 Not supported by printer type 
Bottom 
F12=Cancel 
XN oy 


The Confirm Delete of Page Layout Elements display shows the list elements in 
the page layout to be deleted due to change of the PFD specifications. The Reason 
column shows why the element is to be deleted. 


You can delete these elements by pressing Enter. If you don’t want to delete these 
elements, press F12 to cancel. Then, the Define PFD Specifications display appears. 


Table 25. Confirm Delete of Page Layout Elements display fields 


Column Description 

Mark Shows the element mark. 

Name Shows the element name that is assigned for each element on the 
Create or Change Element Detail display. 

Position Across Shows the horizontal position of the element. 

Position Down Shows the vertical position of the element. 

Reason Shows the reason the element is to be deleted. 
Out of page 


The position of the element is not within the size specified 

in the PFD specifications 

* If the element is text, bar code, or page segment, its start 
position is outside. 

* If the element is line, box, or graphics, its bottom-right 
corner is outside. 


* If the element is record layout, its last repetition is 
outside. 


Not supported by printer type 
This type of element is not supported by the printer type 
specified with the PFD specifications. 


If the element is graphics, the printer does not support the 
function to print graphics. 
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Work with PFD Definition Fonts 
For the work with fonts operations, see 
bage 294 


Specify Database File 


‘a Specify Database File “ 


Type choices, press Enter. 


Database chile: js cay cs. 40 ie eee Name, F4 for list 
MailbRarny ere. See wwtsc re ae ce cea eas QGPL Name, *LIBL, *CURLIB 
Record: Tormmde “. s a0y a GS as *FIRST Name, *FIRST, F4 for list 


F3=Exit F4=Prompt F5=Refresh  F12=Cancel 


i i 


On this display, specify the name of the database file to be printed and the name 
of the library that contains the database file. If the file has more than one record 
format, you must also specify the record format to be used. 


The following table explains each field of the Specify Database File display. 
Table 26. Specify Database File display fields 


Field Name Description 

Database file Specifies the name of the database file to be printed. Use F4 to list 
the database file names in the library. 

Library Specifies the library name which contains the database file to be 
printed. *CURLIB or *LIBL can also be specified for library. 

Record format Specifies the record format name in the database file to be printed. 


*FIRST can also be specified. When the Enter key is pressed, *FIRST 
is replaced by the actual name of the format. Use F4 to list the 
record format names. 


If it is not necessary to list the database file nor record format name, type the fields 
and press the Enter key. The display for another action appears. 


To list record formats, move the cursor to the Record format prompt, press the F4 
key, and go to (De 


To list database files, move the cursor to the Database file prompt and press the F4 
key. 
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Select Database File 
ie = 


Select Database File 


LSID RaRy 2s Gy) stax teuete vee se tse OGRE 
ROSAIETON EO. 5 tense: ten bey 2 oe Starting characters 


Type option, press Enter. 


1=Select 

Opt File Text 
QAAPFILE Symbol set symbol definitions logical file 
QAAPFILE$ Symbol set small symbol definitions 
QAAPFILE# Symbol set medium symbol definitions 
QAAPFILE@ Symbol set large symbol definitions 
QAFCGRPH SAMPLE GDF 

1 QAFCPFDDTA SAMPLE DATABASE FILE FOR PFU 
QAFCTUTDBF SAMPLE DATABASE FILE FOR TUTORIAL 
QAFCTUTOR AFPU TUTORIAL TEXT 


QAFCTUTPFD AFP Utilities for iSeries tutorial PFD file 
QAFCTUTXMP Sample PFD File 
QAFCXMPAI2 SAMPLE DATABASE FILE (AIAG_B2) 
More... 
F5=Refresh  F12=Cancel 


\ e 


On this display, the names and the descriptions of database files in the specified 
library are listed. 


The following table explains each field of the Select Database File display. 
Table 27. Select Database File display fields 


Field Name Description 
Library The name of the library in which the database files reside is shown. 
Position to This prompt is used for quick repositioning of the list, not for 


creating a subset of the list. Choose one of the following: 
*TOP To go to the top of the list. 
*BOT To go to the bottom of the list. 


name or partial name 
Specifies the name or partial name for positioning the list. 
The list is positioned to the first name beginning with the 
string specified. 


1=Select To select a database file from the list. 

Opt Specify 1 (Select) in the Opt column beside the database file to select. 

File Shows the names of the database files that reside in the library 
specified. 

Text Shows the description text of the database files. 


Specify 1 in the Opt column beside the database file to select, and press the Enter 
key. 


When you specify the database file (and the record format, if necessary), the 
display goes to (De 
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Select Record Format 
a sy 


Select Record Format 


Database fille 3.4% <3. = 8 QAFCPFDDTA 
IEVDRARYS <oei sare tsapeeeete: QGPL 
Type option, press Enter. 
1=Select 
Record 
Opt Format Text 
1 PRODMASTER Product master 
QUALITY Quality data 
ROADMAP Road map 


Bottom 
F5=Refresh  F12=Cancel 


sc 7 


On this display, the name and the descriptions of record formats in the specified 
database file are listed. 


The following table explains each field of the Select Record Format display. 
Table 28. Select Record Format display fields 


Field Name Description 

Database file Shows the name of the database file specified. 

Library Shows the name of the library in which the database file resides. 

1=Select Allows the selection of a record format from the list. 

Opt Specify 1 in the Opt column beside the record format you want to be 
selected. 

Record Format Shows the names of the record formats that are contained in the 
database file specified. 

Text The description text of the record formats that are contained in the 


database file specified. 


Specify 1 in the Opt column beside the record format to be selected and press the 
Enter key. The Specify Database File display appears. 
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Specify Break Fields 


‘< Specify Break Fields ) 


Database fillies 23 40 covse eis QAFCPFDDTA 
Library <a = sie ce  @ QGPL 
Record! formate iss) cs -e wt PRODMASTER 
Type option, press Enter. 
1=Select 
Opt Field Length Type Text 
NAME 15 C PRODUCT NAME 
CODE 8 C PRODUCT CODE 
NATION 15 C THE COUNTRY NAME DEVELOPED 
PRICE 3,0 P PRODUCT PRICE 
AMOUNT 4,0 P AMOUNT OF STOCK 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 


Ne oA 


This display allows you to specify which fields will cause a page break when you 
want start a new page according to the field value in the record even if the 
number of the records in the current page does not reach the page maximum. 
When the value of the record in the specified fields is not equal to that of the 
previous record, the Print Format Utility starts a new page before printing the 
record. 


If two or more fields are specified as break fields, a page break occurs when the 
value of any of the specified fields for a record is not equal to that of the previous 
record. On this display, the names, the length, the type, and the descriptions of the 
fields in the specified database file are listed. 


The following table explains each field of the Specify Break Fields display. 
Table 29. Specify Break Fields display fields 


Field Name Description 

Database file Shows the name of the database file specified on the Specify 
Database File display. 

Library Shows the name of the library in which the database file resides. 

Record format Shows the name of the record format specified on the Specify 
Database File display. 

1=Select Allows the selection of a field from the list. 

Opt Type 1 in the Opt column beside fields to be selected. The selected 
fields which cause the page break are called ‘break fields’. 

Field Shows the names of the fields which are contained in the specified 
record format. 

Length Shows the lengths of the fields which are contained in the specified 


record format. 
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Table 29. Specify Break Fields display fields (continued) 


Field Name 


Description 


Type 


Text 


Shows the type of the fields which are contained in the specified 
record format. 


G 
VG 


Packed decimal data field. 

Zoned decimal data field. 

Binary data field. 

Floating point data field. 
Character data field. 

DBCS data-capable field. 
Variable character data field. 
Variable DBCS data-capable field. 
Date data field. 

Time data field. 

Timestamp data field. 
DBCS-graphic data field. 
Variable DBCS-graphic data field. 


Shows the description text of the fields. 


Type 1 in the Opt column beside the fields to be selected and press the Enter key. 


Design Record Layout 


In this section, records are distinguished depending on their definitions as follows: 


¢ The record defined in the is referred to as a database file record. 


* The record defined by the following process with the Print Format Utility based 
on the database file record will be simply referred to as a record. 


/ 


Control 


001 
002 


Fll=Bar code 


Design Record Layout 
PFD definition 
More athena Discenwthe spol ciara tiers gee Sivvsiv eters s Aare atherees sO ventas ee Ole aeretiace «ad viene 


F6=Text 
F21=Element edit 


~ 


Columns: 1- 74 


PRODUCTLBL 


More... 
F9=Line 
F22=Block edit 


F10=Box 
F24=More keys 
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Initially, there is nothing defined in the record. From this display, you can define 
the record layout, that is, which fields of the database file member or which 
elements such as a line, a box, or a bar code will be printed at what location 
within the record which is defined for the PFD definition. 


Data in Record Layout 
There are three types of data that can be specified. 


¢ Variable data 
¢ Reserved variable data 
° Fixed data 


Variable Data: The field data from a database file (printed as text, bar codes, and 
referred to page segment names, or graphic names) is called variable data. You can 
specify not only their locations in the record layout, but also the fonts used for the 
text, if it is underlined or not, color, direction, bar code types, and so on. 


Use one of the following to specify the name of a field whose value is printed: 
the Text data prompt for text elements 
the Bar code data prompt for bar code elements 
the Text data prompt for box elements 


Field names must be uppercase and enclosed with an ampersand (&) and a period 
(.). For example, specify a field name PRODCT as follows: 


Text data . . . . &PRODCT. 


Field names and constant data may be concatenated in a prompt. The following 
are all correct values: 
ABC&PRODCT . XYZ 


&PRODCT.&PRICE. 
The &PRODCT. is the best product, and price is &PRICE. dollars. 


The name of a field that contains an object name to be printed can be specified by 
using one of the following: 

For page segments, the Page segment prompt 

For graphics elements, the Folder prompt, Document prompt, File prompt, 


Library prompt, and Member prompt 


Field names must be uppercase and enclosed with an ampersand (&) and a period 
(.). Concatenating two or more variable fields and fixed data is allowed the same 
as for variable text data. 


For more information about the mapping name, see 


Note: Variable data can be specified only in the record layout. 


Reserved Variable Data: The following data can be specified as text on a text 
element or on a box element in the record layout in the same manner as printing 
variable data from the database file. The following reserved variable names can be 
specified to print the variable data: 
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Table 30. Reserved Variable Names 


*DATE The date the Print Database File Member job is requested. 
*TIME The time the Print Database File Member job is requested. 
*PAGNBR The number of the page on which the record is printed. 
*RCDNBR The record number within the database file. 

*DBFIL The name of the database file to be printed. 

*DBLIB The library name of the database file. 

*DBMBR The name of the member to be printed. 


To select reserved variable names, press the F4 key on the Define Text Detail (or 
the Define Box Detail) display. The following display appears: 
le aN 


Select Field in Record Format 


Database: fille: <a ak, a 8 MLTFMT 
brary. ce se aoe aS SENDAI 
RecorditFormats as At ee MLTFMT 


Type an option, press Enter. 


1=Select 
Opt Field Length Type Text 
AREA 8 C Area products developed 
PRICE 3 P Price of the product 
PRODCT 12 C Product name 
SIZE 4 P Size 


Bottom 
F5=Refresh Fl1l=Select reserved variable  F12=Cancel 


3 a 


Then press the F11 key. The following display appears: 
a Ne TLC 


Select Reserved Variable Name 


Type option, press Enter. 


1=Select 

Opt Reserved variable name Description 
*DATE Job date 
*TIME Job time 
*PAGNBR Page number 
*RCDNBR Record number 
*DBFIL Database file name 
*DBLIB Database library name 
*DBMBR Database member name 


F5=Refresh Fl1l=Select field F12=Cancel 
XN / 
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Type 1 in the Opt column beside the reserved variable name to select and press the 
Enter key. The Define Text Detail (or the Define Box Detail) display appears with 
the selected reserved variable name enclosed with an ampersand (&) and a period 


(.). 


The reserved variable name can be concatenated with variable data (field names) 
or fixed data as follows: 


Page number: &*PAGNBR. 
&*DATE.-&*TIME. 
&COMPANY. is in the record number &*RCDNBR.. 


Note: Reserved variable data is printed in the following format: 


* The job date is printed with the date format and the date separator 
defined on the job definition attribute. 


* The job time is printed with the time separator defined on the job 
definition attribute. 


* The page number is printed as eight-digit numeric data. The leading zeros 
are suppressed with blanks. 


* The record number is printed as eight-digit numeric data. The leading 
zeros are suppressed with blanks. 


Fixed Data: In addition to the data from a database file, data called fixed data can 
be defined when the PFD definition is created or changed. 


Any combination of the following elements can be printed as fixed data in a record 
layout: 


Table 31. Fixed Data elements 


Text Text with various fonts, underlined or not, color, and so on. 
Lines and Boxes With various length, width, dashed, dotted, shaded, and so on. 
Bar Codes For the supported bar code types, see (Bar Code” on page 227. 
Page segments converted either from PC documents or physical 
Images . 
file members. 
Graphics The graphics data (GDF format) that reside in a physical file 


member or a PC document in a folder. 


To create a PFD definition containing fixed data, define the contents of these 
elements. They are not affected by the contents of the to be printed. Some 
examples of using these elements are: 


Text: Title 
Lines and Boxes: Box 
Images: Logo 


The following is a sample of variable data and fixed data in a record layout and a 
page layout. 
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Image data 


Logical page 


Position-and-trim 
mapping 


Mapped Image 


Figure 19. Position-and-trim mapping 
1. Variable data defined in the record layout: 


Text The name (Raymond Bills) and the employee number (058297). 
The employee number (058297) is printed as a bar code below the 

Bar code : 

employee number printed as text. 


2. Fixed data defined in the record layout: 


Text "Employee name :” and "Employee number :” 
Line Line between the text elements 
Box Box around the text elements 


3. Fixed data defined in the page layout (the page layout is described in a later 


section): 
Text "Employee record” and "iSeries Stationery Co., Ltd.” 
Image The logo at the top. 


Concatenation of Variable Data and Fixed Data: You can concatenate variable data 
and fixed data by typing the text as follows: 
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Design Record Layout Columns: 1- 74 
Control. .. PED definition... « -: PRODUCTLBL 
Weta tics sce brane othenc eed cerca tis see D visiecethviewieA wore atheieus Ors ears thewe Deis vat ewcicil «ees 


004 7001 


More... 
Define Text 
Mavksttc cee cee pee ce TOOT Measurement method . . . . : Row/Column 
POSMALON: GS che Across 16 Down 4 
Text data .. . . Product name : Price 3 


F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 


S / 


You can define fixed data in the same way data is defined with the overlay utility. 


See (Chapte Zi for more information about the 


design operation. 


When you complete designing the record layout, press the F3 key to exit from this 
display. 


Numeric Editing 

The Print Format Utility allows you to specify an edit code with which the 
numeric data from the database file should be printed. If any edit code is not 
specified, the Print Format Utility prints the numeric field data according to the 
editing information on the field definition, or the default format when the editing 
information does not exist. 


The Print Format Utility allows you to specify an edit code for a field on the 
following elements in a record layout. 


¢ Text data on a text element 
¢ Text data on a box element 


When a field name is specified on the Text data prompt on the Define Text Detail 


display or on the Define Box Detail display, press the F10 key and the following 
display appears: 
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Edit Numeric 
Rilcl dae eursip ea ere er ee LCE 
Type choices, press Enter. 


EdVinCOd@ 25 fos a ee wee % 1-4, A-D, J-Q, X-Z 
User-defined 5-9 


Edit code: modifier’. = 325 4 i. a5 1l=Asterisk fill 
2=Floating currency symbol 


F3=Exit F5=Refresh  F12=Cancel 
Xe A 


On this display, you can specify an edit code and an edit code modifier. 


Field Name Description 

Field Shows the name of the field for which an edit code and edit code 
modifier can be specified. 

Edit code Specifies the edit code which will be used when the numeric field 


is printed. The allowable edit codes (1-9, A-D, J-Q, X-Z) and their 
printout format are the same as those supported by DDS. If this 
parameter is not specified, the Print Format Utility prints the field 
based on the editing information defined by DDS or IDDU. 

Edit code modifier This parameter is optional. It is effective only when one of 1-4, 
A-D, and J-Q is specified for the edit code parameter. 


1 An asterisk (*) is printed for each zero that is suppressed. 
A complete field of asterisks is printed for a zero balance 
field. 

2 The currency symbol defined on the system value 


QCURSYM is printed to the left of the first significant 
digit. The symbol is not printed on a zero balance when 
an edit code is used that suppresses the zero balance. 


When you specify the above parameters and press the Enter key, the Define Text 
Detail display appears again. 


When you specify multiple fields on the Text data prompt, the Select Fields to Edit 
Numeric display appears to select fields before the Edit Numeric display appears. 
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XN 


Select Fields to Edit Numeric 


Type options, press Enter. 


1 


Opt 


=Select 


Field 
PRICE 
AMOUNT 


Bottom 


F5=Refresh  F12=Cancel 


Z 


The Edit Numeric display appears repeatedly for each selected field, and the Select 
Fields to Edit Numeric display appears again when the numeric code for the 
selected fields are specified. 


Press Enter or the F12 key on the select display, then return to the Define Text 


Detail display (or the Define Box Detail display). 


Design Page Layout 
From the following display you can specify the design of the page layout. 


a 


Con 


001 
002 
003 
004 
005 
006 
007 
008 


Fll 


Design Page Layout Columns: 1- 74 
trol... PED definition . <. « « PRODUCTLBL 
iaroeectwtetare Mora tereatistetouel aneveve tiers ers Sianereteticteuerel ie lavevactretareisin escconestistoncrs Olsja suectoverctarle esapsre 


More... 
Exit F6=Text F9=Line F10=Box 
=Bar code F21=Element edit F22=Block edit F24=More keys 
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Initially, there is nothing defined in this page layout. Place records and define fixed 
data and variable data, such as summary data or reserved variable data in the 
page interactively. 


You can define fixed data in the same way you do using the Overlay Utility. See 
Zi for more information about the design 


operation. 


You can place the record in the following steps. 


Press the F24 key to change the function key area in the following display. 
a Design Page Layout Columns: 1- 74 > 
Control -.:. PED Sdemi nations 7. 8 20s PRODUCTLBL 
Keo roctisess steel cnonetesbi ey esse e-aecsey calves creuc Oienetaverticvone si iasctene iercserm Oat etaceak: smotve Olcsencucrtue nets cet) oysters 


001 

002 

003 

004 

005 

006 

007 

008 

009 

010 

011 

012 

013 

014 

015 

016 

017 

More... 

F5=Refresh F13=Place F14=Change F15=Mark on/off 
F16=Hide F1l7=List view F24=More keys 


SS 4 


The function key area changes and F13 (Place) is displayed. To place a record, 
move the cursor to the desired position and press F13. The following display 
appears: 
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Design Page Layout Columns: 1- 74 
Control 2 .. PED definition: <0 3: PRODUCTLBL 
Mecca tives ace beare-othec eed eerre ts seed visisiethy erste A score atheseu Ov were thew cere sat ewe «eres 


f=} 
S 
5B 
oe 


More... 
F3=Exit F6=Place graphics F9=Place page segment 
Fll=Place record layout F12=Cancel F24=More keys 
Press F6, F9 or F1l for graphics, page segment or record layout. 


\ / 


A % indicates the cursor position. (A mark is not displayed because the element 
type has not been specified.) 


When F11 is pressed to place a record, a mark %R001-001 is displayed at the cursor 
position in the image area and the key entry area appears at the bottom portion of 
the display. The cursor moves to the first input field of the key entry area as 
follows: 


i Design Page Layout Columns: 1- 74 ) 
Control . . PED definition . < . « « PRODUCTLBL 
MSaracsctheverere:Ussrsnarectic erape/Ciote tere Piese ode Quareresetuetaness Gh sterevact wcanstel) ioceconestuarccege Ojarevenetisseser silver stsce 
001 
002 
003 
004 %RO01-001 
005 
006 
007 
008 
009 
010 
011 
012 


More... 
Place Record Layout 
Maekivesve: usscco css : *ROO1 Measurement method . . . . : Row/Column 
POSTtTON: s. ae Ay es. Across 10 Down 4 


F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 


SS oy 


The mark for the record layout has a trailing repetition number. This repetition 
number will be incremented by 1, such as *R001-002, *RQQ1-003 , and so on, when 
the record layout is repeated. See "Repetition of the Record in the Page” on the 
following page for details on repetition of records. 
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When you press the Enter key, the record is placed and a mark *RO01-001 is 
displayed at the position of the record. This mark indicates that the record is the 
first one in the page and not a repeated one. 


Repetition of the Record in the Page 

There are two directions to repeat the records in the page. One is to repeat the 
records horizontally - from left to right first, and then from top to bottom. The 
other is to repeat the records vertically - from top to bottom first, and then from 
left to right. The following are examples: 


Sample of repeating records vertically 


Image to go here 


Sample of repeating records horizontally 


Image to go here 


To place the record repeatedly press F4 (Detail) to show the Place Record Layout 
Detail display. 
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( Place Record Layout Detail +) 
Mark:  *ROQ1 Measurement method: Row/Column 
Type choices, press Enter. 
Position: 
IACKOSSitecutsass vce ceac utente ears 10 1-999 
DOWN rc: cs se coe fx eh ver Ses oe tee 4 1-999 
Elements. 7s ces csu se tcp es cn vedas os) ce Name 
Direction: 6 3.46 ~@ ss & 8 1 1=Across, 2=Down 
Repetition: 
INCNOS Stuecca usu St iedact cts re ences 1 1-99 
DOWilire marca an enesce see ek es 1 1-99 
Distance: 
INCNOS Seoeyes esi dsmicdact te reuse oe ss 1-999 
DOWN cts: os vedo: ce~ Get es Soh ven enw 1-999 
F3=Exit F5=Refresh F6=Change measurement method  F12=Cancel 
a oA 


From this display, you can specify further detail characteristics of the record 
element. For example, you can specify the direction, repetition, and distance. 


The following table explains each field of the Place Record Layout Detail display. 


Table 32. Place Record Layout display fields 


Field Name 


Description 


Mark 


Measurement method 


Position 


Element 


Shows the element mark. A mark is either a system-assigned mark 
or a user assigned-name, and is the same as that shown on the 
display. A mark is six characters long, the first character is an 
asterisk (*), and the last character is a blank. 


* For a system-assigned mark, the middle four characters are one 
character for the element type followed by a three-digit sequence 
number. For record layouts, the element type is R and the 
sequence number is 001 to 999. 


* For a user-assigned name, the middle four characters are four 
characters specified as the value for the element name. 


Note: When the record mark is displayed on the Design Page 
Layout screen, a dash and a three-digit repetition number are 
inserted after the fifth character of the record mark (for example, 
*ROO01-001 ). 

Shows the measurement method used to specify position. You can 
change this value by pressing F6. You can also select centimeters or 
inches for the measurement unit in the Define PFD Specifications 
display by specifying unit of measure. 

The record position is defined by the horizontal distance (across) and 
the vertical distance (down) from the page origin. 


Across Specifies the horizontal origin of the element in the 
specified measurement method. 


Down Specifies the vertical origin of the element in the specified 
measurement method. 

An element name is 1 to 4 characters in length. If an element name 

is specified (not blank) for an element, the element mark is displayed 

as an asterisk (*) followed by the element name. It is not an asterisk 

(*) followed by the element type and three-digit sequence number. 
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Table 32. Place Record Layout display fields (continued) 


Field Name Description 


Direction Records can be repeated in two directions. Select one of the 


following for the direction: 
1 Across (from left to right first and then from top to bottom.) 


2 Down (from top to bottom first and then from left to right.) 


Repetition Specifies how many times records are repeated on the page. 


Across Specifies how many times records are repeated on the page 
horizontally. 


Down _ Specifies how many times records are repeated on the page 
vertically. 


Distance Specifies the horizontal and the vertical distances between records. 


Across Specifies the horizontal distance between records in the 
specified measurement method. 


Down _ Specifies the vertical distance between records in the 
specified measurement method. 


Type all choices and press the Enter key. 


For example, specify the following data and press the Enter key. 


(a Place Record Layout Detail : 
Mark: *ROO1 Measurement method: Row/Column 
Type choices, press the Enter key. 
Position: 
ACROSS eecer nee tense saeco coats 10 1-999 
DOWNS -cukciec ees mney por eote mma te esate 4 1-999 
EVemenit: Gercecss esate @ ote sites os Name 
DiiKECtIONG en Se. eee ce tn ee us 1=Across, 2=Down 
Repetition: 
AGKOSS#i, o. catscas Seis cece ee 3 1-99 
DOWN: 6 Ss WS Ke vA 1-99 
Distance: 
AChOSScot trarcar tc cse serena neers 25: 1-999 
DOWNS fen ey ce: oe wee aes eae See ton ee 8 1-999 
Bottom 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method  F12=Cancel 
NG 7 


The following figure shows the above choices: 
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Position-Down 


Position- 
Across 


Distance- 

Across 
Direction : 1 
Repetition-Across: 3 
Repetition-Down : 2 
Distance-Across : 25 
Distance-Down : 8 


The following display appears: 


Distance- 
Down 


i 


001 
002 
003 
004 *ROO01-001 
005 
006 


012 *RO01-004 


016 
017 


F3=Exit F6=Text 
Fll=Bar code F21=Element edit 


Design Page Layout 
Control «... PED definition «= 2% 
Pe Graes trevereres Meorataroaticterate; Cionevare tevecede Qiccsrerectisvane et etercrentscanstc) ererorestisresciel Ola aleve tietersiat/-cssrsce 


*ROO1-002 


*RQ01-005 


F9=Line 
F22=Block edit 


PRODUCTLBL 


Columns: 1- 74 


*ROO1-003 


*ROO1-006 


More... 
F10=Box 
F24=More keys 
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The records are displayed as *RQQ1-001, *ROO1-002, .. . *RO01-006 . Now you 
have completed placing the record(s) in the page. If you want to place fixed data 
(text, line, box, image, graphics, or bar code) in the page in addition to the record, 
move the cursor to the position you want to start the fixed data, and press the 
following keys. 


F6 To define a text element. 

F9 To define a line. 

F10 To define a box. 

F11 To define a bar code. 

F13, then F6 To place a graphics element. 
F13, then F9 To place a page segment. 


Zifor more information about the 


design operation. 


The following display is an example of the page layout with four fixed data 
elements (three text elements, *T002, *T003, *T004, and one page segment, *S005). 


2 Design Page Layout Columns: 1- 74 ») 


Control: yes. PFD definition. .... PRODUCTLBL 


001 *T002 print of product and price *S005 
002 *T003 is as follows: 1 2 3 

003 *T004 6 

004 *ROO1-001 *ROO1-002 *RO01-003 


12 *ROO1-004 *RQ01-005 *ROO1-006 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


‘2 = 4 


When you press the F15 key to set mark off, the text can be fully displayed as 
follows: 
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XX 


Design Page Layout Columns: 1- 74 
Control 2 .. PED definition). ss. : PRODUCTLBL 


001 Label print of product and price *S005 
002 Layout is as follows: 1 2 3 
003 4 5 6 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


Note: The mark *S005 remains since this is the last element in the page. 


You can also define the following summary data to print summarized data of field 
values in the grouped database records as a text element or as text in a box 
element. 


The field value of the first record in the group. 
The field value of the last record in the group. 
The total of the field values in the group. 

The average of the field values in the group. 
The minimum field value in the group. 

The maximum field value in the group. 


The number of records in the group. 


The summary data can be printed in the following two groups: 


Records in a page (summary for a page). 


The summary for a page is printed on the same page containing the 
summarized records. 


Records from a page break to the next page break (summary for page break). 


The summary data for page break is printed on the page containing the last 
record of the group. 
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The following example shows how each of the summary data is printed on the 


page: 
Database : 
PRODUCT BRANCH SALES 

Record 1 | Color TV Boston 200 | 
Record 2 Color TV Chicago 500 
Record 3 | Color TV Los Angeles 1000 | 
Record 4 | Color TV. Miami 100 | 
Record 5 Color TV. San Francisco 800 
Record 6 | Color TV St. Louis 40 | 
Record 7 Color TV. Washington 300 
Record 8 | Radio Denver 100 | 
Record 9 Radio Milwaukee 200 
Record 10 | Radio Santa Fe 60 | 
Record 11 | Radio Boca Raton 300 | 
Record 12 | Video New York 500 | 


PFD Definition : 


- PRODUCT is the break field 
Specify the summary data of SALES for a page 
Specify the summary data of SALES for page break 


| - Place four records in a page | 
| | 


Print the database file with the PFD definition 
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Placed Records : Record 1 
Record 2 
Record 3 
Record 4 


Summary data of SALES for page 


First value : 200 (from Record 1) 

Last value : 100 (from Record 4) 
Total : 1800 (from Record 1-4) 
Average : 450 (Total/record count) 
Maximum : 1000 (from Record 3) 
Minimum : 100 (from Record 4) 
Record count: 4 


Summary data of SALES for page break 


First value : Not printed 


Last value : Not printed 
Total : Not printed 
Average : Not printed 
Maximum : Not printed 
Minimum : Not printed 


Record count: Not printed 


Note: The page break does not occur on page 1 because the value of the 
PRODUCT field does not change. Therefore, summary data for the page 
break is not printed. 
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Placed Records : Record 5 
Record 6 
Record 7 


Summary data of Sales for page 


First value : 800 (from Record 5) 
Last value : 300 (from Record 7) 


Total : 1140 (from Record 5-7) 
Average : 380 (Total/record count) 
Maximum : 800 (from Record 5) 
Minimum : 40 (from Record 6) 
Record count: 3 


Summary data of SALES for page break 


First value : 200 (from Record 1) 
Last value : 300 (from Record 7) 


Total : 2940 (from Record 1-7) 
Average : 420 (Total/record count) 
Maximum : 1000 (from Record 3) 
Minimum : 40 (from Record 6) 
Record count: 7 


Note: The page break occurs on record 8. Record 8 is printed on the next page. 
The summary data for the page break summarizes all sales data for 
PRODUCT Color TV. 


Page 3 
Placed Records : Record 8 
Record 9 
Record 10 
Record 11 


Summary data of Sales for page 


First value : 100 (from Record 8) 
Last value : 300 (from Record 11) 


Total : 660 (from Record 8-11) 
Average : 165 (Total/record count) 
Maximum : 300 (from Record 11) 
Minimum : 60 (from Record 10) 
Record count: 4 


Summary data of SALES for page break 


First value : 100 (from Record 8) 
Last value : 300 (from Record 11) 


Total : 660 (from Record 8-11) 
Average : 165 (Total/record count) 
Maximum : 300 (from Record 11) 
Minimum : 60 (from Record 10) 
Record count: 4 


Note: The page break occurs on record 12. This page contains the last record 
before the page break, so the summary data for the page break is printed on 
this page. The previous page break occurred on the previous page, so the 
summary data for the page break is equal to the summary data for the page, 
and it summarizes all sales data for PRODUCT Radio. 
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The end of data is handled as a page break. The summary data for the page break 
is printed on the last page. 


To define summary data in a text element or a box element in a page layout, you 
need to specify which field is summarized, and which summary data is printed on 
the Text data prompt by typing an ampersand (&), the field name, a left parenthesis 
‘(, the strings for the summary data, a right parenthesis ’)’, and a period ’.’ 
without inserting any spaces as follows: 


Text data . . . . &SALES (*TOTAL). 


The strings for each summary data are: 


Table 33. Summary data strings 


Summary Data Strings 
First value *FIRST 
Last value *LAST 
Total *TOTAL 
Average *AVG 
Maximum value *MAX 
Minimum value *MIN 
Record count *CNT 


You can press the F4 key on the Text prompt of the Define Text Detail display or 
the Define Box Detail display to display the Select Field in Record Format display 
as with the Design Record Layout display. 


When you select a database file field on the Select field in Record Format display 
and press the Enter key, the Define Text Detail display (or the Define Box Detail 
display) appears with the selected field in the Text data prompt as follows: 


Textodata. once 42 a cw ewe ae a 8 &SALES (*FIRST). 


*FIRST is the default summary function. You can show the Define Summary Data 
display by pressing the F10 key, and change the summary function. You can also 
specify an edit code for the summary data on the display. 


fe > 


Define Summary Data 


FUGliCl Sencar PRICE 
Type choices, press Enter. 


Summary FUNCEMON +3: verse: 22 eo ss see se ce *FIRST *FIRST, *LAST, *TOTAL, *AVG 
*MAX, *MIN, *CNT 


Numeric editing: 


EGE GOde. G4 <.,a) ae, wie ence 1-4, A-D, J-Q, X-Z 
User-defined 5-9 


Edit: code modifier: “3. 2. <i. 1=Asterisk fill 
2=Floating currency symbol 


F3=Exit F5=Refresh  F12=Cancel 
Ne e 
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Field Name 


Description 


Field 
Summary 
function 


Edit code 


Edit code 
modifier 


Shows the field name for which the summary function is being used. 
Shows the special value used to summarize the field values. The 
following summary function special values can be specified to print the 
summary data. 


*FIRST The first value in the specified field. 
*LAST The last value in the specified field. 


*TOTAL 
The total of the values in the specified field. This summary data 
is effective for numeric fields, excluding floating-point data. The 
number of integer digits of the total is the number of integer 
digits of the field plus three. For example, the total of the field 
whose integer digits are three and the fractional digits are two is 
printed as numeric data with six integer digits and two 
fractional digits. 


*AVG _ The average of the value in the specified field. This summary 
data is effective for numeric fields, excluding floating-point data. 


*MAX The maximum value in the specified field. 
*MIN 
The minimum value in the specified field. 


*CNT The record count. It is printed as an 8 digit integer. If there is a 
record whose field value is null, the record is not counted. 
Specifies the edit code in which the summary data is printed. The 
allowable edit codes (1-9, A-D, J-Q, X-Z) and their printout format are the 
same as those supported on DDS. If this parameter is not specified, the 
Print Format Utility prints the field based on the editing information 
defined by DDS or IDDU except for the record count. The Print Format 
Utility prints the record count with the leading zeros suppression by 
blanks if an edit code is not specified. 
This parameter is optional. It is effective only when one of 1-4, A-D, and 
J-Q is specified on the edit code parameter. 


1 An asterisk (*) is printed for each zero that is suppressed. A 
complete field of asterisks is printed for a zero balance field. 


2 The currency symbol defined on the system value QCURSYM is 
printed on the left of the first significant digit. The symbol is not 
printed on a zero balance when an edit code is used that 
suppresses the zero balance. 


When you specify the above parameters and press the Enter key, the Define Text 
Detail display (or the Define Box Detail display) appears again. 


When you specify multiple summary data on the Text data prompt, the Select 
Fields to Define Summary Data display appears. You can select fields to change the 
summary function or specify an edit code on the display. 


The Define Summary Data display appears repeatedly for each selected field. 


If you specify break fields, you can print the summary data for each page break or 
for each page by specifying Y or N for the Print at page break only prompt on the 
Define Text Detail display (or the Define Box Detail display). The Print at page break 
only prompt appears at the bottom of the Detail display, and it appears only when 


182 AFP Utilities for iSeries: User’s Guide 


you specify break fields. For example, if you want to print the total of the SALES 
field for each page, specify the prompts as follows: 


Text: data. 0. 6% a a a Gc ee &SALES (*TOTAL). 


Print at page break only .. N 


If you want to print the total of the SALES field only for page breaks, specify the 
prompts as follows: 


Text Uitdn be eas oa Ge &SALES (*TOTAL) . 


Print at page break only .. bf 


You can concatenate summary data with other summary data, constants, and 
reserved variable names as follows: 


&SALES(TOTALS) is for &PRODUCT (*FIRST).. 
&SALES (*TOTAL). as of &*DATE.. 


You can also specify the following elements to be printed only when a page break 
occurs. For example, you can print them as the header and the frame of summary 
data. 


¢ Text element 

* Bar code element 

* Box element 

¢ Line element 

* Page segment element 
* Graphics element 


To print an element only when a page break occurs, specify Y for the Print at page 
break only prompt on the detail display such as the Define Line Detail display. 
When the element is specified to be printed only when a page break occurs, the 
mark on the design display is displayed with the character ’>’ after the element 
number as follows: 


*L001> 
*T002> 


You can define reserved variable data both in a page layout and in a record layout. 


Note: The value used for the *RCDNBR special value in a page layout is the 
record number of the last record on the page. 


for more information. 


When you have completed the design of the page layout, press the F3 key to exit 
from the Design Page Layout display. 


Specify Record Selection 


This is an optional step. If no conditions are specified for record selection from this 
display, all records in the database file member are printed. 
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Specify Record Selection 


Type choices, press the Enter key. 
Tests: EQ, NE, LE, GE, LT, GT, RANGE 


AND/OR Field Test Value (Field, number, or 'character') 
F4 for list F4 for list 
PRODCT NE ‘Wrong one' 
AND  PRODCT NE "Bad' 


F3=Exit F4=Prompt F5=Refresh  F12=Cancel 
Se ey 


You can specify up to five logical conditions to select records. The Print Format 
Utility compares the content of the specified field of each record with the specified 
value, and prints only those records whose test results are true. 
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The following table describes the columns in the Specify Record Selection display. 


Table 34. Specify Record Selection display fields 


Column Description 


AND/OR AND and OR are the only values that you can specify in the AND/OR 
column. If this column is left blank and the other three columns (Field, 


Test and 


Value) in the same line are specified, AND is assumed. 


If AND and OR are specified together, AND is evaluated before OR. For 


example, 


AND 
OR 
AND 


YEAR EQ 1990 
MONTH RANGE 11 12 
YEAR EQ 1991 


MONTH RANGE 1 2 


means the period from November, 1990 through February, 1991. 
Field Any fields of the input record format in the input database file can be 


specified 
after pos 


. You can list all fields in the database file by pressing the F4 key 
itioning the cursor in this column. 


Test Test is the logical condition for data selection. One of the following can 


be specif 
EQ 


NE 


LE 


GE 


LT 


GT 


RANGE 


ied: 
Test is positive when the content of the field is equal to the 
value. For example, 

PRICE EQ 200 


Records are selected if the field PRICE contains a value of 200. 


Test is positive when the content of the field is not equal to the 
value. 


Test is positive when the content of the field is less than or equal 
to the value. 


Test is positive when the content of the field is greater than or 
equal to the value. 


Test is positive when the content of the field is less than the 
value. 


Test is positive when the content of the field is greater than the 
value. 


Test is positive when the content of the field is between or equal 
to one of the two values. 


PRICE RANGE 100 300 


Records are selected if the field PRICE contains a value between 
100 and 300. This the same as the following: 


PRICE GE 100 
AND PRICE LE 300 
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Table 34. Specify Record Selection display fields (continued) 


Column 


Description 


Value 


One of the following can be specified: 
¢ Numeric constant 


This is possible when the field is numeric type data. A numeric 
constant can be from 1 to 31 digits long, and can contain the following 
characters: 


— Digits (0 through 9) 
-— Aplus sign (+) or minus sign (-) at the beginning 
— A period. 


Floating point expressions are not allowed, although floating point 
data is allowed. 


Examples: 

Correct Incorrect Reason 

+12.5 +12.5.0 2 periods are contained. 
-20 20- - does not come first 
.00005 .0000A5 "A" is not numeric 


123456 1.23456E+5 Floating point expression 
¢ Character constant like ABC’ 


This is possible when the field is character type data. The maximum 
for a character length is the same as the length of the Value column. A 
character constant is simply characters enclosed in apostrophes (for 
example, ’xxx’). If a character constant contains an apostrophe, it must 
be entered as two apostrophes. For example, if you want to print 
records that list the street addresses as Granger’s Circle, type the 
constant as ’Granger’s Circle’. 


Examples: 

Correct Incorrect Reason 

"ABCDEF' ABCDEF No apostrophe, recog- 
nized as a field name. 

‘abc def' ‘abc def Last apostrophe is 
missing. 

'Tom''s bed' ‘Tom's bed' Double apostrophe is 
required. 

'123456' 123456 No apostrophe, recog- 
nized as a numeric 
constant. 


¢ A field name in the database file member 


Any fields in the input database file member can be specified, but its 
data type must match with the data type specified in the Field column. 
For example, if the data type is numeric, you must specify it as 
numeric data. If it is character data, you must specify it as character 
data. Comparison of SBCS type and DBCS type is allowed. 


You can select a field name from the list of field names in the database 
file by pressing F4. 


If a field and a value are not of the same length, the Print Format Utility 
handles the shorter one as if it has the same length as the longer one as 
follows: 


* 0’s are added at the left of numeric values. 
* SBCS blanks are added at the right of character values. 
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Define Printout Specifications 


‘a Define Printout Specifications ) 
Type choices, press Enter. 
COPTeS Hee cue tence wey apa ees oman 1 1-255 
Print tid @lity a .c heros oes ese see *CONTENT *CONTENT, *ABSOLUTE 
Preiind quality” Socal cer ies ens *STD *STD, *DRAFT, *NLQ 
Print: on both sides, « < . 2 « « *NO *NO, *YES, *TUMBLE 
Omit back side page layout .... N Y=Yes, N=No 
FOWITIRELSY Cer mare” rrarehccchmcotin eekec une neice tes *STD Character value, *STD 
Source dYaWEr 46 ns & Se ee 1 1-255, *El, *CUT 
Front side overlay: 
OVENIAY i testis, ei ee es See se ese *NONE Name, *NONE, F4 for list 
ibnaryoe eee cacecey curser ot coke *LIBL Name, *LIBL, *CURLIB 
ORTSEECAGCMOSS® 5.0.5) ar otro san -00 0.00-22.75 
OFTSEESCOWNT Seaec ose aes: Fe ciewees cs) -00 0.00-22.75 
Back side overlay: 
OVENRIAY sos Wes: oe ce Ge cee ee we *NONE Name, *NONE, F4 for list 
iD Parry! taewreter aco ar eeoeco eueescen *LIBL Name, *LIBL, *CURLIB 
OPESCECAGKOSS! 9 Sitcycce velo. on carne -00 0.00-22.75 
Offset down) 3. <5 @ wow Ge -00 0.00-22.75 
More... 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel 
S y 
c Define Printout Specifications ) 
Type choices, press Enter. 
EOPMECOHUMT COM. cS) ante oe ee coe ces o> ceca cae *DEVD Name, *DEVD, *INLINE 
Librairyyanc ces leek tec: oa ee *CONTENT Name, *LIBL, *CURLIB 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel 
Ne ey 


The Define Printout Specifications display allows you to define how the printout 
will be printed, such as: 


Number of copies 
Print quality 
Source drawer 
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Prompt 


Description 


Copies 


Print fidelity 


Print quality 


Print on both 
sides 


Specifies the number of copies to print. 


The possible values are: 
1 Only one copy of the output is printed. 
number-of-copies 

Specify a value ranging from 1 through 255. 


Specifies what action should be taken when any errors are detected when 
the printout is being printed by the writer. 


The possible values are: 


*CONTENT 
Printing is performed as long as there is any way to correct the 
error. For example, 
¢ Alternate font is used if the specified font is not available. 
¢ Data is ignored and not printed if the function is not 
supported by the destination printer. A bar code is an example. 


*ABSOLUTE 
Printing is canceled when any errors are found. Printing 
completes only when the file can be printed exactly as is 
specified by the data stream. For example, 


¢ Alternate font is used, if the specified font is not available, only 
when a font of the identical characteristics is available. 
Otherwise, printing is canceled. 


Specifies the quality of printout produced. 


The possible values are: 
*STD The output is printed with standard quality. 


*DRAFT 
The output is printed with draft quality. 


*NLQ _ The output is printed with near letter quality. 

Specifies whether the output is printed on one side or on both sides of the 
paper. 

The possible values are: 

*NO The output is printed on one side of the paper. 


*YES The output is printed on both sides of the paper with the top of 
each printed page at the same end of the sheet of paper. This is 
usually done for output that is bound at the side. 


*TUMBLE 
The output is printed on both sides of the paper with the top of 
one printed page at the opposite end from the top of the other 
printed page. This is usually used for output that is bound at the 
top. 
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Prompt 


Description 


Omit back side 
page layout 


Form type 


Source drawer 


Front side 
overlay 


Library 


Offset across 


Offset down 


Specifies whether the page layout should be printed only on the front side 
of the paper. This option is used when only a back side overlay is to be 
printed on the back side of the paper. 


The possible values are: 
N (No) The page layout is printed on both sides of the paper 


Y (Yes) The page layout is printed only on the front side of the paper. 
Note: Y can only be specified for Omit back side page layout 
when Y is specified for Duplex and a back side overlay is 
specified. 

Specifies the type of forms used in the printer. 


The possible values are: 
*STD The standard form for your system is used. 


Form-type 
Specify the identifier of the form type used with this printer 
device file for printed output. 

Specifies the source drawer used when cut sheets are fed into the printer. 


The possible values are: 
1-255 Specifies the number of the source drawer. 
*El The envelopes are fed from the envelope drawer. 


*CUT For printers with manual feed, cut sheets are fed manually 
through the manual feeder. 

Specifies that the name of the overlay and library to be printed on the 

front side of the page. This parameter also specifies the point where the 

overlay is placed. The possible values are: 


*NONE 
No overlay is to be used. 


Overlay name 
Specify the name of the overlay. 


You can list the overlay name by pressing F4 after moving the cursor to 
this prompt. 
The possible values for library are: 


*LIBL The library list is used to locate the overlay. 


*CURLIB 
The current library for the job is used to locate the overlay. If no 
library is specified as the current library for the job, library QGPL 
is used. 


Name _ Specify the name of the library where the overlay is located. 
Specifies the horizontal position where the overlay is placed (the offset). 


Valid value range is 
* 0.0-22.75 (in inches) 


* 0.0-57.79 (in centimeters) 
Specifies the vertical position where the overlay is placed (the offset). 


Valid value range is 
* 0.0-22.75 (in inches) 
* 0.0-57.79 (in centimeters) 
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Prompt 


Description 


Back side 
overlay 


Library 


Offset across 


Offset down 


Form definition 


Library 


Specifies the name of the overlay and library be printed on the back side 
of the page. This parameter also specifies the point where the overlay is 
placed. The possible values are: 


*NONE 
No overlay is to be used. 


Overlay name 
Specify the name of the overlay. 


You can list the overlay name by pressing F4 after moving the cursor to 
this prompt. 
The possible values for library are: 


*LIBL The library list is used to locate the overlay. 


*CURLIB 
The current library for the job is used to locate the overlay. If no 
library is specified as the current library for the job, library QGPL 
is used. 


Name _ Specify the name of the library where the overlay is located. 
Specifies the horizontal position where the overlay is placed (the offset). 


Valid value range is 

* 0.0-22.75 (in inches) 

* 0.0-57.79 (in centimeters) 

Specifies the vertical position where the overlay is placed (the offset). 


Valid value range is 
* 0.0-22.75 (in inches) 
* 0.0-57.79 (in centimeters) 


Specifies the form definition to be used when printing the spooled file 
created by the print format utility. 


The possible values are: 


*DEVD 
Specifies that the form definition specified in the device 
description should be used. 


*INLINE 
Specifies that the Print Format Utility should create an inline 
form definition to be used when printing the data. See the form 
definition help text for additional information. 


Form definition name 
Specifies the name of the form definition. 
The possible values for library are: 


*LIBL The library list is used to locate the form definition. 


*CURLIB 
The current library for the job is used to locate the form 
definition. If no library is specified as the current library for the 
job, library QGPL is used. 


Name _ Specifies the name of the library where the form definition is 
located. 


190 AFP Utilities for iSeries: User’s Guide 


Specify Mapping Object Name 


‘a Specify Mapping Object Name ) 


Type options, press the Enter key. 
1=Select 


OPT Object 

Page segment 
Folder 

PC document 
Library 

File 

Member 


[aa 


Bottom 
F3=Exit F5=Refresh F12=Cancel 


Ne oA 


You can specify field names in the object name parameters of the Place Page 
Segment display or the Place Graphics display. When you specify field names, you 
can specify the mapping of a field value to an object name, if required. 


For example, if you want to print various logos of the company based on the 
company name field in the database file, you need to name the page segment 
objects containing the logo data the same as the company names in the field. But 
in some cases, the length and the characters of the company name may be invalid 
for iSeries object names. AFP Utilities for iSeries provides the function that maps a 
field value in the database file to an object name in the iSeries system for the 
above case. 


You can specify which value should be mapped to which iSeries object name. The 
mapping can be specified for each object type, page segment, document, folder, 
file, library, and member. For example, a field value IBM Co.’ can be mapped to a 
page segment name ’QFCLOGO’ and a file name ‘QAFCGRPH’. 


When variable data is specified for page segments or graphics, AFP Utilities for 
iSeries first searches the specified mapping for the object type in the PFD 
definition. If no mapping is specified for the object type, or the searching field 
value is not found, the field value is taken as an object name. If the length of the 
field value is longer than the maximum object name length, the characters on the 
right are ignored. 


The Specify Mapping Object Name display allows you to select the object to 
specify the mapping. You can select: 


* Page segment 
¢ Folder 

* PC document 
* Library 

¢ File 

* Member 
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Field Name Description 


1=Select Allows you to select one or more objects from the list. 
Opt Specify 1 (Select) in the Opt column beside the object you want to select. 
Object The objects for which you can specify the mapping. 


When you select Page segment on the Specify Mapping Object Name display, the 
following display appears: 


Note: Similar displays appear for other objects. 


fe Mapping Page Segment Name 


Type choices, press the Enter key. 


Page 
NBR Database field value segment 


F3=Exit F5=Refresh  F12=Cancel 


XS 


192 AFP Utilities for iSeries: User’s Guide 


The following table explains each field of the Mapping Page Segment Name 


display: 

Table 35. Mapping Page Segment Name display fields 

Field Name Description 

NBR Shows the serial number of the mapping. You can specify up to 99 


Database field value 


Page segment 


mappings. 

Specifies the field value in the database record. The comparison 
between the data specified on this field and the data in the record is 
processed as characters with blank padding to the right of actual 
data. 


If the field is a numeric field, AFP Utilities for iSeries converts the 
numeric value to a character string based on the numeric definition 
(total digit, fractional digit, edit code, and so on). Then AFP Utilities 
for iSeries searches the value in the mapping with the converted 
string. 


You can specify an asterisk (*) as a wild card. AFP Utilities for 
iSeries maps all variable data beginning with the specified 
characters. The format of wild card is ’ABC*’. When you use this 
wild card, all variables beginning with ‘ABC’ such as ‘ABC’, 
‘ABCD’, or ‘ABC123’ can be mapped to the object specified in the 
Page segment field. 


Note: When a page segment matches more than one value specified 
in the database field value, the value with the lowest sequence 
number is tested first. This should be considered when a wildcard 
is first in sequence. In the following example, the wildcard is tested 
first and will get a match on ‘ABC.’ The mapping values ‘ABC’ and 
‘ABA’ are never tested. 


NBR Database field value 


1 AB* 
2 ABC 
3 ABA 


Specifies the page segment name to which the field value should be 
mapped. 


Note: You can specify the data in the same way when other object types are 


mapped. 


Chapter 10. Work with PFD Definitions 193 


Saving PFD Definition 

When you complete the PFD definition, the Create PFD Definition display or the 
Change PFD Definition display appears. Press the F3 key to exit from defining 
PFD definition. The following display appears: 


( ‘ 


Exit PFD Definition 
Type choices, press Enter. 
QPENONT eee cot ysuoaestces tetas nce 1 l=Save and exit 
2=Exit without saving 
3=Resume PFU session 
Return to PFD definition list. . ¥ Y=Yes, N=No 
F12=Cancel 
SS y 


You can specify how you exit from PFD definition. You can choose: 
* Whether or not to save the PFD definition. 
* Which display you want to return to. 


The following table explains each field of the Exit PFD Definition display. 
Table 36. Exit PFD Definition display fields 


Field Name Description 
Option Specify one of the following numbers to specify how you want to 
handle the PFD definition that you were just working with: 
1 The Save and exit prompt allows you to save the PFD 
definition that you have just created and to exit from the task. 
2 The Exit without saving prompt allows you to exit from the 
task without saving the PFD definition that you have just 
created. 
3 The Resume PFU session allows you to return to the Create 
PFD Definition display or the Change PFD Definition display. 
Return to PFD Specifies one of the following selections: 


epee neal iet Y (Yes) Returns to the Work with PFD Definitions display. 


N (No) Bypasses the Work with PFD Definitions display and returns 
to the display from which you started the print format utility. 


Type all choices and press the Enter key. 


When you specify 1 in the Option prompt and Y in the Return to PFD definition list 
prompt, the following display appears: 
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a Save PFD Definition > 
Type choices, press Enter. 
PRO GeTinition ss « 2 oo a ae oe x PFDNEW Name, F4 for list 
Fath@rcciee <0) astter con setese ens ies sen eek Sone dee PFUFILE Name, F4 for list 
EV ee saeeecosernn rete Mar acreere aryernene PFULIB Name, *CURLIB 
Text: -desenipttonir <2. 2. ce as fe Sample PFD definition 
Delete removed elements ...... N Y=Yes, N=No 
F4=Prompt F5=Refresh  F12=Cancel 
\ J 


Specify the name of the PFD definition, the PFD definition file, the library, and the 


description text. 


You can also specify whether or not to delete any removed elements. 


The following table explains each field of the Save PFD Definition display. 


Table 37. Save PFD Definition display fields 


Field Name 


Description 


PFD definition 


File 


Library 


Text ‘description’ 


Delete removed elements 


Specifies the name of the PFD definition used to store the 
definition you have just created. This name must be a valid 
iSeries member name. 


You can see the list of existing PFD definitions in the specified 
PFD definition file by pressing F4. 

Specifies the name of the PFD definition file in which the PFD 
definition is stored. This name must be a valid iSeries file name. 


You can see the list of existing PFD definition files in the 
specified library by pressing F4 and selecting a PFD definition 
file from the list. 

Specifies the name of the library to locate the PFD definition file 
in which to store the PFD definition. This name must be a valid 
iSeries library name. 

Specifies up to 50 characters that describe the PFD definition that 
is being saved. 

Specify Y (Yes) if you want to delete removed elements and 
re-number other elements, otherwise N (No). 
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When you press the Enter key after specifying these prompts, the following 


display appears: 
(— : rae 
Work with PFD Definitions 
UG) sees) vm Yen iot sr ave cst Gee ce PFUFILE Name, F4 for list 
LID KARY ose irc) ewiceeeerce ce PFULIB Name, *LIBL, *CURLIB 
PED definition <a % us. *ALL Name, generic*, *ALL 
Position: tol 4 2 sa. se Starting characters 


Type options, press the Enter key. 
l=Create 2=Change 3=Copy 4=Delete 6=Print PFD definition 7=Rename 
9=Print database file 


PFD 

Opt Definition Text Changed 
PFDNEW 
PFDNEW Sample PFD definition 12/13/90 
PFD1 Sample PFD definition 12/13/90 
PFD2 Sample PFD definition 12/13/90 
PFD3 Sample PFD definition 12/13/90 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 
F12=Cancel 
PFD definition PFDNEW saved in file PFUFILE successfully. 


Press the F3 key to exit from the above display. The display from which you 
started Print Format Utility appears. 
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2=Change PFD Definition 


To change a PFD definition, do the following in the display on page 4d. 
1. Type 2 in the Opt column beside the PFD definition that you want to change. 
2. Press the Enter key. 


The following display appears: 


‘e Change PFD Definition ) 


ile toms tama elecnsaesircs tose) PRU DEE: 
[SIDA eeateu cua cue st concoues PFULIB 
PFD definition . ..... :  PFDNEW 


Type options, press the Enter key. 
1=Select 


Opt Action 
Define PFD specifications 
Work with PFD definition fonts 


1 Specify database file 
Specify break field 

1 Design record layout 

1 Design page layout 


Specify record selection 
Define printout specifications 
Specify mapping object name 


F3=Exit F5=Refresh F9=Select all F12=Cancel 


To change a PFD definition, select the actions on the above display in the same 
way to create a PFD definition. See 47\ for 
more information. 
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3=Copy PFD Definition 


To copy a PFD definition, do the following on the display on page had 


1. Type 3 in the Opt column beside the PFD definition that you want to copy. 


2. Press the Enter key. 


The following display appears: 


( Copy PFD Definition 
Rromvtiler <2 ac se ee | REURLUE 
Library certs cee es ee PFULIB 
PFD definition . .... .. 2  PFDNEW 
TOXE) she eos ee Se es «| Sample PRDCdetinition 


TOsshanle@xiae: ccesset Secse eeuen eons PFUFILE Name, F4 for list 
BDAY? aeeteee sec ee ce cess PFULIB Name, *LIBL, *CURLIB 
PFD Sdet i nitiony ss ns: Ste ce os PFDNEW2 Name 


Text 'description’..... Sample PFD definition 


F3=Exit F4=Prompt F5=Refresh  F12=Cancel 


Using the Copy PFD Definition display, you can copy a PFD definition in the same 


or different file or library. 


The following table explains each field of the Copy PFD Definition display. 


Table 38. Copy PFD Definition display fields 


Field Name Description 

From file Shows the name of the PFD definition file that contains the PFD 
definition you are going to copy. 

Library Shows the name of the library containing the file with the PFD 
definition you are going to copy. 

PFD definition Shows the name of the PFD definition you are going to copy. 

Text Shows the text description of the PFD definition you are going to copy. 

To file Specifies the PFD definition file you are going to copy the PFD 


definition to. 


Press F4 to go to a selection list of PFD definition files in the specified 
library. 


This prompt has the same file name as the from PFD definition file 
name. Leave the default if you want to copy the PFD definition to a 
different PFD definition name or to a different library with the same 
file name. 
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Table 38. Copy PFD Definition display fields (continued) 


Field Name 


Description 


Library 


PFD definition 


Text ‘description’ 


Specify the library you are going to copy the PFD definition to. This 
prompt has the same library name as the from library name. Leave the 
default if you want to copy the PFD definition to a different file or to 
a different PFD definition in the same library. The possible values in 
this field are: 


*LIBL To specify the file that will contain the copied PFD definition 
is in one of the libraries in the library list. 


*CURLIB 
To specify that the file that will contain the copied PFD 
definition is in the current library. If no library is specified as 
the current library for the job, library QGPL is used. 


library-name 
Specifies the specific library name you want to copy the PFD 
definition to. 
Specify the new PFD definition you are going to copy to. This prompt 
has the same PFD definition name as the from PFD definition name. 
Leave the default if you want to copy the PFD definition to a different 
file or to a different library with the same PFD definition name. 
Specify a short description of the PFD definition in this prompt or 
leave the default if you want to copy the PFD definition with the same 
description as the description of the from PFD definition. This 
description is saved with the PFD definition and displayed when the 
PFD definitions are listed to help you identify the PFD definitions. 


Change the PFD definition name to PFDNEW2. 


When you press the Enter key, the PFD definition is copied. When the copy is 
completed, the screen returns to the Work with PFD definitions display on page 
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4=Delete PFD Definition 


To delete PFD definitions, do the following on the display on page h43. 
1. Type 4 in the Opt column beside the PFD definition that you want to delete. 
2. Press the Enter key. 


The following display appears: 
ie a 


Confirm Delete of PFD Definitions 


Eid Oeste neiremcnte Moreen wee ase UP EURTEE 
LIDIA Vien een ctivow evasion ans PFULIB 


Press Enter to confirm your choices for 4=Delete. 
Press Fl2 to return to change your choices. 


PFD 
Opt Definition Text Changed 
4 PFDNEW Sample PFD definition 12/13/90 


Bottom 
Fll=Display names only  F12=Cancel 


S = 


On this display, all PFD definitions that are specified to be deleted are listed for 
confirmation. Press the Enter key to confirm your choices for deletion; then these 
PFD definitions are deleted. If you do not want to delete these PFD definitions, 
press F12 to return to the previous display to change your choices. 


The following table explains the Confirm Delete of PFD Definition display. 
Table 39. Confirm Delete of PFD Definition display fields 


Field Name Description 

File The name of the PFD definition file in which the PFD definition 
resides is shown. 

Library Shows the name of the library containing the PFD definition file with 
the PFD definition you chose to delete. 

Opt The Opt column showing the delete option that causes the 
confirmation display to be shown. For this display, the option number 
is always 4. 

PFD Definition Shows a list of all PFD definitions you chose to delete. 

Text Shows the text description of the PFD definition. 

Changed The latest date you changed the PFD definition is shown. 


The PFD definitions you previously chose to delete (option 4), are listed. Confirm 
the list and press the Enter key to delete these definitions or press the F12 key to 
return to change your choice on the Work with PFD definitions display on page 


When the PFD definitions are deleted, the screen returns to the Work with PFD 
definitions display with a message in the 24th line. When two or more definitions 
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are deleted, a message is sent for each definition and a plus (+) sign appears in the 
rightmost column of the 24th line to indicate that more messages are sent from the 
system. They are displayed one after another by pressing the roll-up key after 
moving the cursor to the 24th line. 


6=Print PFD Definition 


To print a PFD definition, do the following on the display on page Lal 
1. Type 6 in the Opt column beside the which you want to print. 
2. Press the Enter key. 


The specified PFD_definition will be printed, and the screen will return to the 
display on page 


7=Rename PFD Definition 


To rename a PFD definition, do the following on the display on page h43l 
1. Type 7 in the Opt column beside the for which you want to change the name. 
2. Press the Enter key. 


The Rename Member display appears. Type the new name of the PFD definition in 
the New member prompt and press the Enter key. 


9=Print Database File 


To start printing a database file, do the following on the display on page 43 
1. Type 9 in the Opt column beside the which you use to print. 
2. Press the Enter key. 


The following display appears on page 143. 
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Chapter 11. Work with PFD Definition Files 


This chapter provides additional information for working with PFD definition files. 


You can select any of the following options from this display. 
* Creating PFD definition file 

* Changing PFD definition file description 

* Copying PFD definition file 

* Deleting PFD definition file 

* Renaming PFD definition file 

* Displaying PFD definition file description 

* Starting work with PFD definitions 


Select 12 (Work with PFD definition files) on the AFP utilities menu on page 139) 
and press Enter. The following display appears: 


CG Work with PFD Definition Files >) 


Type choices, press Enter. 


[SDV AIC Vieie tema comcpts merce nsaes PFULIB Name, *USRLIBL, *LIBL 
*CURLIB, *ALLUSR, *ALL 
Fai Cayes esonce tapes enous reur sees *ALL Name, generic*, *ALL 


Parameters or command 
===> 


F3=Exit F4=Prompt F5=Refresh F9=Retrieve  F12=Cancel 
Ne Zy 


Use this display to select the PFD definition files you want to list and work with. 
You can use the Library and File prompts to specify subset criteria. When you press 
Enter, the Work with PFD Definition Files display appears. The following table 
explains each field on this display. 


203 


Table 40. Work with PFD Definition Files display fields 


Field Name 


Description 


Library 


File 


Specifies the library that contains PFD definition files you want to list 
and work with. Choose from the following: 


library name 
Specifies the name of the library that contains the PFD 
definition files you want to work with. 


*USRLIBL 
Only libraries in the user portion of the job’s library list are 
searched. 


*LIBL All the libraries in the user and system portions of the job’s 
library list are searched. 


Note: This value may cause a long response time until the 
Work with PFD Definition Files display appears. 


*CURLIB 
The current library for the job is searched. If no current entry 
exists in the library list, QGPL is used. 


*ALLUSR 
All “user-defined” libraries are searched. "User-defined" 
libraries include library QGPL, but exclude all other libraries 
with names that begin with the letter "Q". 


Note: This value may cause a long response time until the 
Work with PFD Definition Files display appears. 


*ALL All libraries in the system, including QSYS, are searched. 


Note: This value may cause a long response time until the 
Work with PFD Definition Files display appears. 
Specifies that you want to work with all PFD definition files in the 
library or a subset of PFD definition files in the library. Choose from 
the following: 


PFD definition file name 
Specifies a PFD definition file name for a display with only 
that PFD definition name in the list. 


generic name 
Specifies a partial name of the PFD definition file name 
qualified by an asterisk (*) to display a specific subset of PFD 
definition files. The generic name is the following format: 


ABC* Display a list of all PFD definition files that begin 
with the characters ABC. For example, ABC, ABCD, 
or ABCTEST. 


*ALL — Specifies *ALL to display all the PFD definitions in the 
specified library. 
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Press Enter after specifying the above fields. The following display appears. 
ie = 


Work with PFD Definition Files 


IID Raley snes, (chs mcr tet ce PFULIB Name, *USRLIBL, *LIBL, *CURLIB... 
PANG: gage: a een este reese *ALL Name, generic*, *ALL 
Posaitioni tO .: sss Ae Starting characters 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 7=Rename 8=Display description 
12=Work with PFD definitions 


Opt File Library Text Changed 


PFUFILE PFULIB PFD file for exercise 12/13/90 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1ll=Display names only 
F12=Cancel 
S y 


Use the Work with PFD Definition Files display to can create, change, copy, delete, 
rename, display a description of a PFD definition file, or to start working with PFD 
definitions in a PFD definition file. 


Note: To create a PFD definition file, you need a library in which the PFD 
definition file will reside. If you do not have any libraries, you can create a 
library by entering the Create library (CRTLIB) command on a command 
line on any display. 


This display gives the user the ability to specify the name of the PFD definition file 
(in the File prompt) that you want to list and work with, along with the name of 
the library name (in the Library prompt) to locate the file. 


Note: If the values in either or both of the Library or File prompts are changed, it is 
necessary to press Enter before the user can specify options in the Opt 


column. 


The following tables explain each field of the Work with PFD Definition Files 
display. 
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Prompts 


Table 41. Work with PFD Definition Files prompts 


Prompt 


Library 


File 


Position to 


Description 


Specifies the library that contains PFD definition files you want to list and 
work with. Choose from the following: 


library name 
Specifies the name of the library that contains the PFD definition 
files you want to work with. 


*USRLIBL 
Only libraries in the user portion of the job’s library list are 
searched. 


*LIBL All the libraries in the user and system portions of the job’s 
library list are searched. 


Note: This value may cause a long response time until the 
Work with PFD Definition Files display appears. 


*CURLIB 
Current library for the job is searched. If no current entry exist in 
the library list, QGPL is used. 


*ALLUSR 
All “user-defined” libraries are searched. "User-defined" libraries 
include library QGPL, but exclude all other libraries with names 
that begin with the letter "Q". 


Note: This value may cause a long response time until the Work 
with PFD Definition Files display appears. 


*ALL All libraries in the system, including QSYS, are searched. 
Specifies that you want to work with all PFD definition files in the library 
or a subset of PFD definition files in the library. Choose from the 
following: 


PFD definition file name 
Specifies a PFD definition file name for a display with only that 
PFD definition name in the list. 


generic name 
Specifies a partial name of the PFD definition file name qualified 
by an asterisk (*) to display a specific subset of PFD definition 
files. The generic name is the following format: 


ABC* Display a list of all PFD definition files that begin with 
the characters ABC. For example, ABC, ABCD, or 
ABCTEST. 


*ALL — Specifies *ALL to display all the PFD definitions in the specified 
library. 

This prompt is used for quick repositioning of the list, not for creating a 

subset of the list. Choose one of the following: 


*TOP To go to the top of the list. 
*BOT To go to the bottom of the list. 


name or partial name 
Specifies the name or partial name you want to go to in the list. 
The list is positioned to the first name beginning with the string 
specified. 
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Options 


Table 42. Work with PFD Definition Files options 


Option 


1=Create 


2=Change 


3=Copy 


4=Delete 


7=Rename 


8=Display 
description 


12=Work with 
PFD definitions 


Description 


Creates a PFD definition file. Type 1 in the Opt column, and the name of 
the PFD definition file and library you want to create in the first line in 
the list. 


The Work with PFD Definitions display appears after the PFD definition 
file is created so that you can create PFD definitions in the PFD definition 
file. 

Note: To create a PFD definition file, you need a library in which the 
PFD definition file will reside. If you do not have any libraries, you can 
create a library by entering the Create library (CRTLIB) command on a 
command line on any display. 

Changes the description text of a PFD definition file. Type 2 in the Opt 
column beside the name of the PFD definition file for which you want to 
change its description. 

Copies a PFD definition file to a new PFD definition file. Type 3 in the 
Opt column beside the name of the PFD definition file you want to copy. 
When the PFD definition file is copied, all PFD definitions in the file are 
also copied. 

Deletes a PFD definition file. Type 4 in the Opt column beside the name 
of the PFD definition file you want to delete. You can confirm the choices 
on the next display before deleting them. When the PFD definition file is 
deleted, all PFD definitions in the file are also deleted. 

Renames a PFD definition file. Type 7 in the Opt column beside the name 
of the PFD definition file you want to rename. 

Displays the description of a PFD definition file. Type 8 in the Opt 
column beside the name of the PFD definition file for which you want to 
display its description. 

Starts working with PFD definitions in a PFD definition file. Type 12 in 
the Opt column beside the name of the PFD definition file which contains 
PFD definitions you want to work with. 


Columns 


Table 43. Work with PFD Definition Files columns 


Column 


Description 


Opt 


Specifies the number of the task in the Opt field beside the PFD 
definition file you want to perform the task with. You can type the same 
option next to more than one PFD definition file at a time, and you can 
also type different options next to different PFD definition files at the 
same time. 
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Table 43. Work with PFD Definition Files columns (continued) 


Column Description 


File Shows a list of all the PFD definition files in the specified library or 
library list that meet the subset criteria. You can use the top position in 
the list to type a PFD definition file you want to create or select another 
option. 

Note: If a file meets the following four conditions, it is shown on the 
Work with PFD Definition Files display as a PFD definition file even if it 
is not created as a PFD definition file. 

° The file is a physical file 

¢ The file is not a source file 

¢ The file is not a DDM file 


* The record length is 80 


It is recommended to use the files you created using the Print Format 


Utility. 

Library The name of the library in which the PFD definition file resides is 
shown. 

Text The text description of the PFD definition file is shown. 

Changed The latest date you changed a PFD definition in the PFD definition file 


or you changed the description text of the PFD definition file is shown. 


Showing a PFD Definition File List 


The PFD definition files can be listed on the lower part of the display by 
specifying the Library field and File field. When you want to change the content of 
the list, specify the name of the file and library. You can page up or down the list 
on the display by specifying the starting characters in the Position to prompt. 


Note: When you specify any of the PFD Definition file field and Library field, you 
can not specify the Opt column. 


Selecting a PFD Definition File from a List 


The list on the display contains the names of all or a specified subset of PFD 
definition files that exist in the library (or libraries) indicated by the Library field. 
(However, only the PFD definition files and libraries for which you have the 
necessary authority are shown.) The text that describes the PFD definition files and 
the date the file was last changed are also shown in the list. 


When a list is shown, a one-word indicator always appears below and to the right 
of the list to indicate the position in the list. More... means that there are more 
items after the item currently shown. Bottom means that the end of the list has 
been reached. 


Use the Page or Roll keys to move forward or backward through the list. 


If you are creating a PFD definition file, you can check this list to see what names 
are already used before you choose a new name. You can create a PFD definition 
file by typing 1, a PFD definition file name, and a library name in the first list 
position, and you can select other PFD definition files from the list using any of 
the options except 1 (Create). 


Therefore, you can select one or more names by doing one or both of the 
following: 
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* In the Opt column beside the PFD definition file name in the list that you want 


to use, type the number of option (task) to be used. 


* In only the first (top) position of the list, type an option number (for the task), a 


PFD definition file name and a library name in the Opt, File, and Library 


columns respectively. 


1=Create PFD Definition File 


Before you create a PFD definition, you must create a PFD definition file. To create 


a PFD definition file, do the following on the Work with PFD Definition Files 


display on page 
1. Type 1 in the Opt column in the first line of the list. 


2. Type the name of the new PFD definition file in the File prompt in the first line 


of the list. 


3. Type the name of the library where the PFD definition file resides in the Library 


prompt in the first line of the list. 


4. Press Enter. 


The following display appears: 


fe Create PFD Definition File > 
FAMCr Seren tesa geetectast ar eritense CPRDZ 
LEN IAI) ec wse eee et Seecee Ge vi teas PFULIB 
Type choices, press Enter. 
User specified DBCS data. . N Y=Yes, N=No 
Text “description: . . . 4. File for product label 
AUN OIEY earceecerc mers: seu serene *LIBCRTAUT Name, *LIBCRTAUT, *ALL 
*CHANGE, *EXCLUDE, *USE 
F3=Exit F5=Refresh F12=Cancel 
Ne ey 


Using the Create PFD Definition File display, you can create a PFD definition file 


from the information specified on this display. 


The Work with PFD Definitions display appears after the PFD definition file is 
created, so that you can create PFD definitions in the PFD definition file. 
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Field Name 


Description 


File 
Library 


User specified 


DBCS Data 


Text ‘description’ 


Authority 


Shows the name of the PFD definition file you are going to create. 
Shows the name of the library in which the PFD definition file is 
created. 

This prompt is displayed only when you are in the DBCS system. It 
specifies N (No) or Y (Yes) in this prompt to specify whether DBCS 
(Double-Byte Character Set) data is used in the text data of PFD 
definitions in the PFD definition file or not. 

Specifies a short description of the PFD definition file in this prompt. 
This description is saved with the PFD definition file and displayed 
when the PFD definition files are listed to help you identify the PFD 
definition files. For example, type a short description of your PFD 
definition file, such as: 


Practice PFD definition file. 

Specifies the authority you are giving the users who do not have 
specific authority to the file, who are not on the authorization list, and 
whose users’ group has no specific authority to the file. The possible 
values are: 


*LIBCRTAUT 
The system determines the authority for the file by using the 
value specified on the Create authority prompt (CRTAUT 
parameter) on the Create Library command (CRTLIB) for the 
library containing the file to be created. If the value specified 
on the Create authority prompt (CRTAUT parameter) is 
changed, the new value will not affect any existing files. 


*ALL The user can control the file’s existence, specify the security for 
the file, change the file, change the owner for the file, and 
perform basic functions on the file. ALL authority allows the 
user to perform all operations on the file except those limited 
to the owner or controlled by authorization list management 
rights. 


*CHANGE 
The user can change the file and perform basic functions on 
the file. CHANGE authority allows the user to perform all 
operations on the file except those limited to the owner or 
controlled by object existence authority and object 
management authority. CHANGE authority provides object 
operational authority and all data authority. 


*EXCLUDE 
EXCLUDE authority prevents the user from accessing the file. 


*USE The user can perform basic operations on the file, such as read 
a file. The user is prevented from changing the file. USE 
authority provides object operational authority and read 
authority. 


authorization-list-name 
Specify the name of an authorization list. Users included on 
the authorization list are granted authority to the file as 
specified by the list. The authorization list must exist when the 
file is created. 


When you press Enter, the PFD definition file will be created with the description 
that you gave it, and the screen will return to the Work with PFD Definition Files 


display on page 
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2=Change PFD Definition File 


To change the description of a PFD definition file, do the following on the Work 
with PED Definition Files display on page R05 


1. Type 2 in the Opt column beside the PFD definition file you want to change. 


2. Press Enter. 


The following display appears: 


( Change PFD Definition File = 


lili seekers rea caea, Sr vomcomevmcctsemeet soe Ieee Ue: 
[WDYaiey = ce gees con eges: erie: PFULIB 


Type choices, press Enter. 


Text ‘description’... . PFD file for exercise 


F3=Exit F5=Refresh  F12=Cancel 
Ne oy 


Using the Change PFD Definition File display, you can change the description text 
of a PFD definition file. 


Table 44. Change PFD Definition Files display fields 


Field Name Description 
File Shows the name of the PFD definition file you are going to change. 
Library Shows the name of the library in which the PFD definition file resides. 


Text ‘description’ Specifies the User-defined text that briefly describes the file and its 
function. The text specified here replaces any previous text. 


When you press Enter, the description will be changed. When the change of 
description is is: i the screen returns to the Work with PFD Definition Files 
display on page 
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3=Copy PFD Definition File 


To copy a PFD definition file, do the following on the Work with PFD Definition 
Files display on page bo. 

1. Type 3 in the Opt column beside the PFD definition file you want to copy. 

2. Press Enter. 


The following display appears: 


4 Copy PFD Definition File *) 


From: fetes Seo ee a we revs ssevy see vate PFUFILE 
[I tlo} etl el aomereereectaarte cy hm ranean PFULIB 
eX brgeewcancs cons arc isan here ant cs PFD file for exercise 


Woks pall NP esotree kee sce eeaars pe PFUFILE2 Name 
JES tle) ofl c\'dguara cmec reel purer ye PFULIB Name, *CURLIB 
Text 'description’'..... PFD file for exercise 


F3=Exit F4=Prompt F5=Refresh F9=Retrieve  F12=Cancel 
‘Ss oy 


Using the Copy PFD Definition File display, you can copy a PFD definition file to a 
new PFD definition file. The entire set of PFD definitions will be copied to the new 
file. 


Table 45. Copy PFD Definition Files display fields 


Field Name Description 

From file Shows the name of the PFD definition file you are going to copy from. 
Library Shows the name of the library in which the PFD definition file resides. 
Text Shows the text description of the PFD definition file being copied. 

To file Specifies the new PFD definition file you are going to copy to. This 


prompt has the same file name as the from file name. Leave the 
default if you want to copy the file to a different library with the same 
file name. 

Library Specifies the library you are going to copy the PFD definition file to. 
This prompt has the same library name as the from library name. 
Leave the default if you want to copy the file to a different file in the 
same library. The possible values in this field are: 


*CURLIB 
The current library for the job is used to store the copied file. 


name The specified library name is used to store the copied file. 

Text ‘description’ Specify a short description of the PFD definition file in this prompt or 
leave the default if you want to copy the file with the same file 
description as the from file description. This description is saved with 
the PFD definition file and displayed when the PFD definition files are 
listed to help you identify the PFD definition files. 
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When you press Enter, the file is copied. When the copy is completed, the screen 
returns to the Work with PFD Definition Files display on page |205. 


4=Delete PFD Definition File 


To delete a PFD definition file, do the following on the Work with PFD Definition 
Files display on page bod. 

1. Type 4 in the Opt column beside the PFD definition file you want to delete. 

2. Press Enter. 


The following display appears: 
a > 


Confirm Delete of PFD Definition Files 


Press Enter to confirm your choices for 4=Delete. 
Press Fl2 to return to change your choices. 


Opt File Library Text Changed 
4 PFD2 PFULIB File for product label 12/13/90 


Bottom 


Fll=Display names only  F12=Cancel 


Using the Confirm Delete of PFD Definition Files display, you can confirm that 
you want to delete the files you chose by selecting option 4 (Delete) on the Work 
with PFD Definition Files display. 


Note: You can delete only the PFD definition files for which you have the 
authority to do so. If you do not have *OBJOPR and *OBJEXIST authority 
for a PFD definition file, that PFD definition file is not deleted. 


You should use the displayed list of names to verify that you do want to delete all 
of the PFD definition files shown. If all of them are to be deleted, press Enter to 
delete them. If any of them should not be deleted, press F12 (Cancel). If you press 
F12, you return to the Work with PFD Definition Files display with all selections 
still shown, and you can remove 4 from the column beside the PFD definition file 
you do not want to delete. 


Table 46. Confirm Delete of PFD Definition Files display fields 
Field Name _ Description 


Opt The option field shows the delete option which causes the confirmation 
display to be shown. For this display, the option number is always 4. 

File Shows a list of all PFD definition files you chose to delete. 

Library Shows the name of the library in which the PFD definition file resides. 

Text Shows the text description of the PFD definition file. 

Changed The latest date you changed a PFD definition in the PFD definition file or 


you changed the description text of the PFD definition file is shown. 
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The PFD definition files you previously chose to delete (option 4), are listed. 
Confirm the list and press Enter to delete these files or press the F12 key to return 
poghanee your choice(s) on the Work with PFD Definition Files display on page 


When the files are deleted, the screen returns to the Work with PFD definition files 
with a message in the 24th line. When two or more files are deleted, a message is 
sent for each file, and a plus (+) sign appears in the rightmost column of the 24th 
line to indicate that more messages are sent from the system. They will be 
displayed one after another by pressing the Page-down key after moving the 
cursor to the 24th line. 


7=Rename PFD Definition File 


To rename a PFD definition file, do the following on the Work with PFD Definition 
Files display: 

1. Type 7 in the Opt column beside the PFD definition file you want to rename. 

2. Press Enter. 


The Rename Object display appears. Type the new name of the PFD definition file 
in the New object prompt. 


8=Display Description of PFD Definition File 
To display the description of the PFD definition file, do the following on the Work 
with PFD Definition Files display: 


1. Type 8 in the Opt column beside the PFD definition file for which you want to 
display the description. 


2. Press Enter. 


The display object description (DSPOBJD) command is called and the description 
of the PFD definition file is displayed. 


12=Work with PFD Definitions 


To go to the Work with PFD Definitions display, do the following on the Work 
with PFD Definition Files display. 


1. Type 12 in the Opt column beside the PFD definition file that contains the PFD 
definitions you want to work with. 


2. Press Enter. 


The Work with PFD Definitions display appears. 


for more information. 
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Chapter 12. Print Database File Member 


Once you have designed your Print Format Utility application, you can run the 


application using any of the three following methods: 


By selecting Print database file from the Work with PFD Definitions display. To 


get to the Work with PFD Definitions display, use the STRPFU command or 


STRAFPU option 11. 
By selecting Print database file from the APFU menu. 
By running the PRTPFDDTA command. 


Start Printing from Work with PFD Definitions Display 


To start printing database file members from the Work with PFD Definitions 
display, type 9 in the Opt column beside the PFD definition you want to use to 


print a database file member and then press the Enter key. 


a Work with PFD Definitions > 
FMi@g cesar curscked-ccnteniae Renta PFDFILE Name, F4 for list 
[SIDRaty tice sese cesteneen ae) MYLIB Name, *LIBL, *CURLIB 
PED derinition . <4 % « *ALL Name, generic*, *ALL 
PoSitioni tos. ©, 3s ses Starting characters 
Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 6=Print PFD definition 7=Rename 
9=Print database file 
PFD 
Opt Definition Text Changed 
9 PRODUCTLBL PFD exercise 12/13/90 
Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 
F12=Cancel 
Ne oy 
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The Print Database File Member display appears: 


(a Print Database File Member >) 
Fabl@u eiete snus Goleta acres ec cre = DED TE 
PID Rays itgcrn cxccenew esta somece ce MYLIB 
PFD definition . =... ..s. « ¢  PRODUCTLBL 
Type choices, press Enter. 
Database tile <3 bree a SG *PFD Name, *PFD, F4 for list 
Library: sss, ee es Sie *LIBL Name, *LIBL, *CURLIB 
MONDE so 5. Aw <a ees at ee ee *FIRST Name, *FIRST, F4 for list 
Include grid < . s . % <- N Y=Yes, N=No 
Record selection. ....... Ve Y=Yes, N=No 
Ending! pages fos -s. a ee ce es oe a *END 1-9999, *END 
Source drawer ss 2% ee a = *PFD 1-255, *PFD, *El 
Outputs biini ss ecu Seer, cous as *DEVD 1-65535, *DEVD 
COPMESi ss es) eee oc eee cee oes ns *PFD 1-255, *PFD 
Qutput: queue... 2 ea Se *JOB Name, *JOB 
Library: so coe ses Name, *LIBL, *CURLIB 
More... 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel 
SS ey 
(~ Print Database File Member ) 
Rill@oepesiee cise tanbe) cys cece seepeute ce) I PEDRIUE 
[ID RAY tcercots, kar omecsl ounces ¢ MYLIB 
PED definition’: so as PRODUCTLBL 
Type choices, press Enter. 
Form definition 2:4 3 x ce 46 *PFD Name, *PFD, *DEVD, *INLINE 
[SID aR ccs sip ben seer ie koe Ge es *LIBL Name, *LIBL, *CURLIB 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel 
xo yy 


From this display, you can specify how to print a database file member. You can 


specify: 

* Which database file to print 

* Whether you use record selection 
* When you end printing at a certa 
* Which output queue to use 

* How many copies to print 


216 AFP Utilities for iSeries: User’s Guide 


in page 


The following table describes the Print Database File Member display. 


Table 47. Print Database File Member display fields 


Field Name Description 
File Shows the PFD definition file to use to print a database file. 
Library Shows the library in which the PFD definition file that contains the 


PFD definition 
Database file 


Library 


Member 


Include grid 


Record selection 


Ending page 


PFD definition is located. 

Shows the PFD definition name. 

Specifies the name of the database file which contains the member to 
be printed. To list all database files in the library that is specified on 
the Library prompt, move the cursor to this prompt and press F4. 


If you use the database file specified in the PFD definition, specify 
*PFD. 

Specifies the library that contains the database file. You can choose 
from the following: 


Library name 
Specifies the name of the library that contains the database 
file. 


*LIBL All the libraries in the user and system portions of the job’s 
library list are searched. 


*CURLIB 
Current library for the job is searched. If no current entry 
exist in the library list, library QGPL is used. 
Specifies the database file member name. If you specify *FIRST, the 
first member in the database file is printed. To list all members in the 
file that is specified on the Database file prompt, move the cursor to 
this prompt and press F4. 
Specify one of the following: 


Y (Yes) Prints the database file member with the grid that you 
specified on the Define PFD Specifications display. 


N (No) Prints the database file member without the grid. 


The grid is printed to help you to design the printout. 
Specify one of the following: 


N (No) All records in the database file member are selected whether 
or not record selection was specified in the PFD definition. 


Y (Yes) Records are selected according to the selection condition if the 
record selection condition is specified in the PFD definition. 
All records are selected if no selection condition is specified in 
the PFD definition. 


Specifies the number of the page to stop printing. 
*END _ the prints all selected records. 


n the ends printing after page n is printed. The value can be 
from 1 to 9999. 


This is useful when you check your printout design by printing the 
first few pages as a test. 
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Table 47. Print Database File Member display fields (continued) 


Field Name 


Description 


Source drawer 


Output bin 


Copies 


Output queue 


Library 


Form definition 


Specifies the source drawer used when single-cut sheets are fed into 
the printer. The possible values are: 


*PFD The value specified in the printout specification is used. *PFD 
is the default. 


*E1 Envelopes are fed from the envelope drawer on the sheet-feed 
paper handler. 


*CUT For printers with manual feed, cut sheets are fed manually 
through the manual feeder. 


source-drawer 
Specify the drawer from which the paper is fed. Valid values 
range from 1 through 255. For printers with manual feed, 
specifying 100 is the same as specifying *CUT. 

Specifies the destination of the output on printers capable of multiple 

output bins. The possible values are: 


*DEVD 
The value specified in the Device description is used. *DEVD 
is the default. 


output-bin 
Specify the output bin for the destination of the output. Valid 
values range from 1 through 65535. 

Specifies the number of copies to be printed. 


*PFD The value that is specified in the Printout specifications is used. 


n You can specify 1 to 255. 

Specifies the output queue to put the spooled file that the Print Format 
Utility created. 

Specifies the library to locate the output queue. The possible library 
values are: 


*LIBL The library list is used to locate the output queue. 


*CURLIB 
The current library for the job is used to locate the output 
queue. If no library is specified as the current library for the 
job, QGPL is used. 


library-name 

Specify the library where the output queue resides. 
Specifies the form definition to be used when printing the spooled file 
created by the Print Format Utility. The possible values are: 


*DEVD 
Specifies that the form definition specified in the device 
description should be used. 


*INLINE 
Specifies that the should create an inline form definition to be 
used when printing the data. See the form definition help text 
for additional information. 


Form definition name 
Specify the name of the form definition. 
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Table 47. Print Database File Member display fields (continued) 


Field Name 


Description 


Library 


The possible values for library are: 
*LIBL The library list is used to locate the form definition. 


*CURLIB 
The current library for the job is used to locate the form 
definition. If no library is specified as the current library for 
the job, library QGPL is used. 


Name _ Specify the name of the library where the form definition is 


located. 


You can choose a database file and a member from the list. For example, move the 


cursor to the 


member prompt and press F4. The Select Database File Member 


display appears: 
( Select Database File Member *) 
FUNC: 28 eee ane tk ee ces en tencs QAFCPFDDTA 
Library® Sa we ee eee QGPL 
POSAETON TO! co eh Soe een cs ven os Starting characters 
Type option, press Enter. 
1=Select 
Opt Member Text 
1 QAFCPFDDTA SAMPLE DATABASE FILE FOR PFU 
Bottom 
F5=Refresh  F12=Cancel 


ee 


The database file members that are contained in the database file you specified on 
the previous display are listed. You can page up the list of database file members 
by specifying the starting characters of the name of the database file member in the 
Position to prompt. 
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The following table explains the Select Database File Member display. 
Table 48. Select Database File Member display fields 


Field Name Description 

File Shows the database file which you specified on the previous display. 
Library Shows the name of the library in which the physical file resides. 
Position to This prompt is used for quick repositioning of the list, not for creating 


a subset of the list. Choose one of the following: 
*TOP _ To go to the top of the list. 
*BOT To go to the bottom of the list. 


name or partial name 
Specify the name or partial name you want to go to in the 
list. The list is positioned to the first name beginning with 
the string specified. 


Opt Type a 1 in the Opt column beside the member you want to select. 

Member Shows the names of members which are contained in the database file 
you specified. 

Text Shows the description text of the members which are contained in the 


database file you specified. 


Select a member by typing 1 in the Opt column of the member and press Enter. 


The Print Database File Member display appears. 
(— sy 


Print Database File Member 


FilileNcayeuremeen coeeeescrs eer aaa PED RUE 
IID RAY? i hack ee she oe ae, Gece MYLIB 
PFD definition . .. 4%. « « +  ‘PRODUCTLBL 


Type choices, press Enter. 


Database: witless.) eee clas en QAFCPFDDTA Name, *PFD, F4 for list 
IID RAY ie Se tees ee ss Geen QGPL Name, *LIBL, *CURLIB 
MembG@i in rey use eo uate et ow eo eee QAFCPFDDTA Name, *FIRST, F4 for list 
Tneliude:giidi ws i Sere ceeds N Y=Yes, N=No 
Record selection. ....... i Y=Yes, N=No 
Ending page: «= <3 w 6 0 was *END 1-9999, *END 
Source Drawer aoa 4 & @ a *PFD 1-255, *PFD, *E1 
QUIE DUES DiI a scteuwe™ oy etsy eonen ests *DEVD 1-65535, »*DEVD 
COPIES: sve. ei a we, eee, ee vee toh ees *PFD 1-255, *PFD 
Output: quevess ce ee *JOB Name, *JOB 
AID RAYS tava sescsetiee rea .c ne Rc fe Name, *LIBL, *CURLIB 
More... 


F3=Exit F4=Prompt F5=Refresh  F12=Cancel 
% ue 


If you are ready to print the database file, press Enter. The Print Format Utility 
starts to print the database file. 


When printing completes, the screen returns to the Work with PFD Definitions 
display with either a completion message or an error message displayed 
depending on what happened during printing. The errors detected by the Print 
Format Utility, such as ‘Fields used in the PFD definition are not found in the 
database file’ are printed in the printout listing that is created by the Print Format 
Utility. 
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You can exit from the Work with PFD Definitions display by pressing the F3 key. 


Start Printing from the AFP Utilities Menu 


To start printing, type 13 at the command line on the AFP Utilities menu. 


ce AFPU IBM Advanced Function Printing Utilities for iSeries > 


Select one of the following: 


Overlay Utility 
1. Work with source overlays 
2. Work with source overlay files 


Print Format Utility 
11. Work with PFD definitions 
12. Work with PFD definition files 
13. Print database file member 
14. Print AFP Utilities tutorial 


Resource Management Utility 
21. Convert to page segment 
22. Work with overlays 
23. Work with page segments 


Selection or command 


se=> 13 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel Fl6=System main menu 


SaaS 


The Print Database File Member display appears: 
a ) 


Print Database File Member 
Type choices, press Enter. 
| 35 lh cae ae Oe cera mre ee Name, F4 for list 
LETIDIANY ooo Retes yn “st Ses ee ens MYLIB Name, *LIBL, *CURLIB 
PED erinitiow <6 s kee Name, *FIRST, F4 for list 
Databases hillary. cc tence ee cee nese) 2 QAFCPFDDTA Name, *PFD, F4 for list 
ETD RAY Meresustartateusete ret vet taesac QGPL Name, *LIBL, *CURLIB 
DIEM co eure cae ese eee res ce QAFCPFDDTA Name, *FIRST, F4 for list 
Tncliudergyriid’ tes rcpt relss: 0s esane N Y=Yes, N=No 
Recordi selections «. 2 <a & N Y=Yes, N=No 
Endiingipages eb cea tee cree avnee en 2 *END 1-9999, *END 
Source drawer 4 6 « « «2 sa + *PFD 1-255, *PFD, *E1 
QUI DUES DIM 3 see: ce: Sec as) cee der ows oe *DEVD 1-65535, *DEVD 
COPTNESaicyce aetecdes atu cam crs apewncees a *PFD 1-255, *PFD 
Output queuetys.s.vcrt 3, ve ee ese seay *JOB Name, *JOB 
LENIDRAN Yee cae a a> secre eee ae es Name, *LIBL, *CURLIB 
More... 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel 


Ss oy 


You can show the list of PFD definition files in the specified library. Move the 
cursor to the File prompt, and press the F4 key. 


The Select PFD Definition File display appears: 
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( Select PFD Definition File 
Eibrary «, 25s 3 40 IMYLIB 
POSTETON tO!) as aces 2 Starting characters 
Type option, press Enter. 
1=Select 
Opt File Text 
Gi PFDFILE PFD file for exercise 
Bottom 
F5=Refresh  F12=Cancel 
ie 


You can also show the list of PFD definitions in the specified PFD definition file. 
Move the cursor to the PFD definition prompt on the Print Database File Member 


display, and press the F4 key. 


The Select PFD Definition display appears: 


SE TOE TE I tT \ 


Select PFD Definition 


Rileuss yee aoe ess PED REE 
iibrarye are ee MYLIB 


Type option, press Enter. 


1=Select 
PFD 
Opt Definition Text 
1 PRODUCTLBL PFD exercise 


F5=Refresh  F12=Cancel 


\ 


Starting characters 


Bottom 


See page bid through b21] for more information. 


When printing completes, the screen returns to the AFP Utilities menu with either 
a completion message or an error message which is displayed in the 24th line of 
the display depending on what happened during printing. 
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Start Printing by PRTPFDDTA 


To start printing with command PRTPFDDTA (print a database file member) from 
the iSeries main menu or Command Entry screen, type PRTPFDDTA at the command 
line on the display and press the F4 key. This command allows you to print using 
a PFD with a batch job or submit the print job from a CL program. 


(a MAIN iSeries Main Menu ) 
System: | SYSTNAME 


Select one of the following: 


User tasks 

Office tasks 

General system tasks 

Files, libraries, and folders 
Programming 

Communications 

Define or change the system 
Problem handling 

Display a menu 

Information Assistant options 
iSeries Access tasks 


rFPOWOON AO BPWNHeE 


Pe 


wo 
fo) 


. Sign off 


Selection or command 
===> PRTPFDDTA 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F13=Information Assistant 
F23=Set initial menu 


S oy 


The following command prompt appears: 
C >) 


Print PFD Data (PRTPFDDTA) 
Type choices, press Enter. 
PRDitiiMeatare. ae steers vets teens 
NAME 

IEIDYAIRY.2 Ws) ee eres ash ee es ete ee *LIBL NAME, *LIBL, *CURLIB 
PRDE de taimitiOnh ctor tee a0 se vet tees *FIRST NAME, *FIRST 
Database Tile 2.4.8 @ # ea & 4 *PFD NAME, *PFD 

ISD Yay. se Acie seuss “o> wae ose ce NAME, *LIBL, *CURLIB 
Member ere eadeaacnes ow emnercsrcess ceaess *FIRST NAME, *FIRST 
itt aedl KUCal=s(op ciits hana meer ere emer eras *NO *YES, *NO 
Record Selection « « « « « « « 4 *YES *YES, *NO 
Endaing: page. ves ete es see eed ses *END 1-9999, *END 
Source drawer 4.8 «© « © 4% & 4 *PFD 1-255, *PFD, *E1 
QubpUtSD In ss gametes ue eee ee su eee *DEVD 1-65535, *DEVD 
GOpaeS cata mcm seetancisc tasers rien shee *PFD 1-255, *PFD 
Output: queues. 042 a: eae es te: os *JOB NAME, *JOB 

IDV seen toa etee oem cateweeees NAME, *LIBL, *CURLIB 
Form defination) ©. ics. e Ge. 2 GPs *PFD NAME, *PFD, *DEVD, *INLINE 

END VARY a erase sae cuten wine sec NAME, *LIBL, *CURLIB 

Bottom 

F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


XS o 


See page bid through b21] for more information. 
When printing completes, the screen returns to the previous display with either a 


completion message or an error message displayed in the 24th line of the display 
depending on what happened during printing. 
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Chapter 13. Design Operation 


This chapter describes the following information about the design operation of a 
source overlay, a record layout, or a page layout. 


* The element types that you can define in an overlay, a record layout, or a page 
layout 


* How you define the elements 
* What you can define with the elements 


Element Types 


Text 


Line 


Box 


You can define six elements types in a source overlay, a record layout, and a page 
layout. In a page layout, you can also place a record layout as an element. 


Text that is specified in an overlay, such as ABCDE, is called a text element. It can be 
placed at any specified position on the overlay. Text attributes may also be 
specified to describe text characteristics such as font selection, format, and 
highlighting by underline, overstrike, and/or color. 


A line element is any straight line that connects two points either vertically or 
horizontally. You can select the type of line, such as dotted, dashed, or solid, and 
line width. 


A box element is a rectangle that is defined by two diagonally opposite corners. It 

can be placed anywhere on the overlay. You can select the shade pattern inside the 
box, the type of box line, either dotted, dashed, or solid, and line width. You may 

define text inside the box. Optionally, the text may be justified inside the box. 


Bar Code 


A bar code element is a set of bars and spaces of various widths created from data 
by IPDS printers or the AFP Utilities for iSeries It can be placed at any specified 
position on the overlay. You can specify the following: bar code data; position to be 
placed; type of bar code; and optional attributes such as size, color, whether or not 
to print a human-readable interpretation (HRI), or whether or not to include a 
check digit. 


Page Segment 


A page segment is an image in the AFP resource library. When you want to place a 
page segment in an overlay, you must create the page segment using the Resource 
Management Utility or the CRTPAGSEG command. You can refer to this page 
segment by its name and specify a print position to define it as an element. You 
can include the same page segment repeatedly in an overlay, a page layout, and a 
record layout. 
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Graphics 


You can include graphics data (GDF format) that resides in a physical file member 
or a PC document in a folder. You can refer to the graphics element by its file 
name and member name or by its folder and document name and specify a print 
position and the size to define it by two diagonally opposite corners as an element. 


Record Layout 


A record layout is a function of a PFD definition. You can define the above 
elements in a record using the Print Format Utility and can treat the set of these 
elements as one record layout. In a page layout, a record layout is defined as an 
element. 


Defining Elements on the Design Display 


You can define elements on the following three displays: 
* The Design Overlay display 


This display allows you to design an overlay that contains text elements, line 
elements, box elements, bar code elements, page segments, and graphics 
elements. 


To go to the Design Overlay display, do the following: 
1. On any display with a command line, type STRAFPU and press Enter. 


2. On the Advanced Function Printing Utilities menu, select option 1 (Work 
with source overlays) and press Enter. 


3. The Work with Source Overlays display shows the list of source overlays in a 
source overlay file. If you want to use another source overlay file or library, 
type the name for the Library prompt and the File prompt in the upper part 
of the display, and press Enter. 


4. On the Work with Source Overlays display, do one of the following: 


— To create a new source overlay, type 1 (Create) in the Opt column and a 
new source overlay name in the Source overlay column on the first line in 
the list and press Enter to create a new source overlay. 


— To change an existing source overlay, type 2 (Change) in the Opt column 
and a source overlay name for the Source overlay column in the first line in 
the list or type 2 in the Opt column beside the source overlay you want to 
change in the list, and press Enter. 

5. On the Create Source Overlays display or Change Source Overlay display, 
type 1 (Select) beside the Design Overlay option in the action list, and press 
Enter. 

6. The Design Overlay display appears. 

* The Design Record Layout display 

This display allows you to design a record layout which is a function of a PFD 

definition. The record layout contains text elements, line elements, box elements, 

bar code elements, page segments, and graphics elements. The text elements, 
box elements, bar code elements, page segments, and graphics can be fixed data 
or variable data (contain field names from a database file). 

* The Design Page Layout display 

This display allows you to design a page layout which is a function of a PFD 

definition. The page layout contains text elements, line elements, box elements, 

bar code elements, page segments, graphics elements, and a record layout. 
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To go to the Design Record Layout display or the Design Page Layout display, do 

the following: 

1. On any display with a command line, type STRAFPU and press Enter. 

2. On the Advanced Function Printing Utilities menu, select option 11 (Work with 
PFD definitions) and press Enter. 

3. The Work with PFD Definitions display shows the list of PFD definitions in a 
PFD definition file. If you want to use another PFD definition file or library, 
type the name for the Library prompt and the File prompt in the upper part of 
the display, and press Enter. 

4. On the Work with PFD Definitions display, do one of the following: 

* To create a new PFD definition, type 1 (Create) in the Opt column and a new 
PFD definition name in the PFD definition column on the first line in the list 
to create a new PFD definition and press Enter. 

* To change an existing PFD definition, type 2 (Change) in the Opt column and 
a PFD definition name for the PFD definition column in the first line in the 
list or type 2 in the Opt column beside the PFD definition you want to 
change in the list and press Enter. 

5. On the Create PFD Definitions display or Change PFD Definition display, type 
1 (Select) beside the Design Record Layout or the Design Page Layout in the action 
list, and press Enter. 


6. The Design Record Layout display or the Design Page Layout display appears. 


Design Display 
Two kinds of views of display are provided to design elements as follows: 
* Screen view 


¢ List view 


Screen View 

The screen view shows you an image that is similar to what will be printed. The 
printout image is shown in the upper part of the display called the image area. In 
the screen view, you can specify the position of an element by the cursor position 
in the image area. The design display is initially in the screen view. You can 
change it to the list view by pressing the F17 (Switch view) key. 


9 for more information. 


List View 

In the list view, all element definitions are displayed in the order of the sequence 
number with one element in a line. The order in which the elements are displayed 
can be changed by sorting the list (F4=Sort) by the number (NBR), NAME, 
ACROSS, or DOWN fields. To sort the list, place the cursor on or under one of 
these field names and press F4. The intended use of the list view is to see the 
defined elements in a source overlay, a record layout, or a page layout and make 
minor modifications to the elements. You can easily find an element because you 
can see part of the definitions such as the bar code data and the page segment 
name that are not displayed on the image area in the screen view. You can change 
the display to the screen view by pressing the F17 (Switch view) key. 


for more information. 


Defining Elements in the Screen View 


In the screen view, you can design an overlay, a record layout, or a page layout by 
entering the print image on the display. Because the print image is displayed on 
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Control 


a rn 


the character display, while the actual image is printed on the All Points 
Addressable (APA) printer, you can see only the approximate image of the overlay, 
the record layout, or the page layout on the display. 


Layout of the Screen View 
The screen view of the design display is shown: 


Columns: L« 74 
. STATIONERY 


Design Overlay 
Source overlay . 


ee Lee ee, Cee TR ee eee eee ee ree 


STOOL 


*TOOL 
Pos ition . Across 


Text Data, 


FS= Exit 
FL2=Cancel 


Fa4=Detai 1 
F24=More keys 


F6=Change measurement method 


Image 
area 
More, . 
Define Text 
Measurement method . . . . : Row/Column Key 
__32 Down a} entry 
area 


Function 
Key 
area 


The following table explains each field in the above display. 


Table 49. Design Overlay display in the screen view fields 


Field Name 


Description 


Columns 


Control 


Image area 


Key entry area 


This field shows you the current image area that appears on the display. 
If the More... message appears at the right side of the bottom line of the 
image area, you may move from (scroll) this area to design another area. 
You may scroll the image area window by entering scrolling commands 
in this field and pressing the Enter key. 


When designing an overlay, you may also invoke the AFP Workbench 
Viewer by entering the *VIEW command to see a simulated printout of 
the overlay being designed. The AFP Workbench Viewer will not display 
bar codes created with the Bar Code Object Content Architecture 
(BCOCA). 

The image area is the upper part of the display. It shows the 
approximate print image of an overlay, a record layout, or a page layout. 
You can see what kind of element has been entered and where in the 
image area it was entered. 

The key entry area is the lower part of the display. This area is used to 
enter the parameters to define the elements. It appears only when you 
define or change an element. 


Function key area This area is used to show the function keys currently available. 


230 AFP Utilities for iSeries: User’s Guide 


Element Indication on Image Area - Element Mark 

The element mark always begins with an asterisk (*) followed by an ID that 
identifies the element type, a three digit sequence number, and one blank character. 
Thus, the element mark is displayed in six characters. 


Note: If you specify an element in a page layout to be printed only when a page 
break occurs, ’>’ is displayed after the sequence number instead of a blank 
character. 


When you define an element in the image area on the display, you need to do the 
following: 


1. Move the cursor to the position you want to place the element. 
2. Press the appropriate function key to show the key entry area. 
3. Confirm and change the data for the element in the key entry area. 
You can show the Define Element Detail display by pressing F4 (Detail). 
4. Press Enter to define the element. 


The function keys are assigned for elements as follows: 


Function key Element 

F6 Text 

F9 Line 

F10 Box 

F11 Bar code 

F13 then F6 Graphics 

F13 then F9 Page segment 

F13 then F11 Record layout (in a page layout) 


When you press one of the function keys listed above, you see %Xnnn, which is 
called an element mark at the cursor position. A % shows that the element is 
positioned, but not defined yet. An X is an element ID that shows which element is 
being defined. The element ID is shown as follows: 


Element ID Element 

Text 

Line 

Box 

Bar code 
Page segment 
Graphics 
Record layout 


Aannwre 


When you have completed the element definition by entering parameters and 
pressing Enter, the % of the element mark changes to an asterisk (*). 


The nnn is three digits of sequence number (001 through 999). The sequence 
number is assigned automatically by the Overlay Utility or Print Format Utility. 


In addition to the element marks above, the Overlay Utility and the Print Format 
Utility allow you to assign a name to the element for your convenience. This name 
appears on the image area to show the element position instead of the element 
mark assigned by the Overlay Utility and the Print Format Utility. The Overlay 
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Utility and the Print Format Utility keep the system assigned mark for this element 
even if you have assigned a name for it. The Overlay Utility and the Print Format 
Utility do not use that system assigned mark for elements which have a user 
assigned name. 


The element mark is changed to an asterisk followed by this element’s name on 
the image area. For example, if you define a text element as the first element of an 
overlay and assign a name ABCD, the element mark *T001 is changed to *ABCD. 


To define or change an element name, press F4=Detail from either the Define or 
Change panels. Type the name you wish to assign to the element next to the 
element prompt. 


If you erase the previously assigned name, the Overlay Utility and the Print 
Format Utility replace it by the system assigned mark such as *T001. Any 
characters up to four can be assigned as the element name. 


Even if the length of the element name is less than four characters, the element 
mark occupies six characters, since the mark on the image area consists of an 
asterisk, the name, and a blank character. 


Element Mark On/Off 

The element marks on the image area can be suppressed or re-displayed by 
pressing F15 (Mark On/Off). When the F15 key is first pressed, all the element 
marks displayed on the image area disappear from the display except the last one. 
This is especially useful to verify the entire text element or line/box element 
without overriding other element marks. 


When the F15 key is pressed the second time, all the element marks are displayed 
on the image area again. 


Hide 

One element may be overlapped with other elements in the display. If element 
marks overlap each other on the image area, the one created last is displayed. The 
other overlapped marks are not displayed. By repeatedly creating elements, some 
elements can not be seen on the image area. To solve this problem, the hide 
function is provided. This function temporarily removes elements one by one at 
the position of the cursor, and an element that was overlapped by the hidden one 
appears. You can use this function by pressing F16 (Hide). 


The hidden elements are removed from the image area, but not actually removed. 
You can see them by pressing the F5 (Refresh) key. 


Refresh 

The Overlay Utility and the Print Format Utility also provide the refresh function. 
You can use this function by pressing F5 (Refresh). It restores the elements that 
were temporarily hidden by the hide function. 


Both hide and refresh functions only affect the image shown on the display. They 
do not change the elements you entered nor do they change the printed output 
when an overlay or PFD data is printed. 


Scroll 
The Overlay Utility and the Print Format Utility provide two ways to scroll in the 
screen view and the list view: 


* Function keys 
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* Control field 


Function Keys: Through the image area, you can see the position of the element 
or the entire overlay, page layout, or record layout on the display. The image area 
is similar to a window through which you can see the layout. If the layout is 
longer than the image area, you can see only a part of it. Therefore, you need to 
scroll the image area to see the other parts of the layout. The following keys are 
available to scroll the image area. 


Table 50. Function Keys for Scroll Operation 


Key Function Description 

Roll Down Backward The image area moves toward the top line. 
(Page Up) 

Roll Up (Page Forward The image area moves toward the bottom line. 
Down) 

F19 Left The image area moves toward the first column. 
F20 Right The image area moves toward the last column. 


Control Field: In addition to the scrolling functions provided by function keys, 
the Overlay Utility and the Print Format Utility provide the function to scroll 
through the image area using the Control field on the display. Do the following: 


1. Enter one of the following commands in the Control field on the image area. 
2. Press Enter. 


Table 51. Commands in Control Field for Scroll Operation 
Command Function Description 


—n Backward The image area moves n lines toward the top line. 

+n Forward The image area moves n lines toward the bottom line. 
W-n Left The image area moves n columns toward the first column. 
W+n Right The image area moves n columns toward the last column. 
n Specific line The image area moves to the nth line. 


move 


Wn Specific column The image area moves to the nth column. 
move 
*TOP Absolute line The image area moves to the first line. 
move 
*BOT Absolute line The image area moves to the last line. 
move 
*VIEW A simulated printout is displayed on the workstation. See 


Control field help for further information. 


Element Operations in the Screen View 


In the screen view, you can do the following element operations: 


* Define (place) an element 


* Change an element 


* Edit an element (copy, move, or remove) 


* Edit a block of elements (copy, move, or remove) 


The operational steps are different for each operation, but you need to scroll the 
image area until your desired part is displayed before you start the following 
operations. 
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Define Element Operation 

You can enter the define element operation by pressing the F6, F9, F10, F11, or F13 
key depending on the element type to be defined. With the define element 
operation, you can define an element of an overlay, a record layout, or a page 
layout. 


The key entry area is displayed. Its format depends on the type of element to be 
defined. The fields which allow input are the mandatory parameters to define the 
element. If you need to specify additional characteristics of the element, you need 
to show the Define Detail display by pressing F4 (Detail). 


For details of this operation, see one of the following: 


im 


Change Element Operation 

You can enter the change element operation by pressing the F14 (Change) key 
when the cursor is on the mark of an element. The key entry area appears and the 
remainder of the operation is the same as that of Define Element Operation. The 
cursor is considered to be on the mark if the cursor is on the asterisk of a mark or 
on the four characters which follow. 


You can also duplicate any element while changing the element except the placed 
record on a page layout. From the Change Element screen, press the F13 (Repeat 
element) key. The Repeat Element screen will be displayed. 


On the Repeat Element screen you can specify the position of the first repetition, 
the element name, the direction of the repetitions, the number of repetitions across 
and down, and the distance across and down from one element to the next. For 
additional information on the Repeat element function, see the help text on the 
Repeat element screen. 


Edit Operation 

You enter the edit operation by pressing the F21 or F22 key in the screen view 
display. You can edit elements one by one (Element edit), or in a block by 
specifying two diagonally opposite positions (Block edit). F21 (Element edit) starts 
the element edit operation, while F22 (Block edit) starts the block edit operation. 
The functions for both edit types are copy, move, and remove. For the element 
edit, the cursor is used to select an element by placing it at the element mark. For 
the block edit, the cursor is used to select a block by specifying two diagonally 
opposite positions. 


Specify one of the move, copy, or remove operations for the selected element or for 
the block by pressing the appropriate function key. The operation takes place for 
all elements in the block, even if some of them are not displayed. In the case of 
line elements, box elements, and graphics elements, the entire element must be 
surrounded by the specified block. For the other elements, those elements whose 
mark (first asterisk only) is in the block will be selected. 
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You need to place the cursor at the position where the selected element or block is 
copied or moved to, and press the appropriate function key. To remove, press the 
appropriate function key. 


For more detailed information, see one of the following: 
* "Element Edit” on page baa. 
* "Block Edit” on page bad. 


Function Keys on the Design Display 
On the Design display, some function keys work the same regardless of the 
operation that is performed, while some function keys work differently depending 
on the operation. 


The following function keys work the same: (* after the key name indicates the key 
cannot be used in the list view. @ after the key name indicates the key can be used 
only in the list view.) 


Table 52. Common Function Keys for all Operations on the Design Display 


Key Function Description 
Fl Help Displays different help screens at various cursor positions. 
F5 * Refresh Restores the elements that have been previously hidden by the F16 


key. This key only affects the display of the overlay images on the 
screen, but does not change the elements you entered. 


This function key cannot be used in the list view. 

F15 * Mark on/off Re-displays or suppresses the element marks on the image area. This 
function lets you view the entire text, line, or box element without 
being overridden by other element marks. 


This function key cannot be used in the list view. 

F16 * Hide Hides the element consecutively at the cursor position. This function 
is used to view the elements in the image area. Elements which are 
hidden still exist and will be printed. 


This function key cannot be used in the list view. 


F19 Left Moves the image area toward the first column position. 

F20 Right Moves the image area toward the last column position. 

F24 More keys _ Displays the function key assignments not currently displayed. 
Roll Up Forward Moves the image area toward the bottom line. 

(Page 

Down) 

Roll Backward Moves the image area toward the top line. 

Down 

(Page 

Up) 


You are in the base operation when: 

* You enter the Design display. 

* You end the operation of defining an element by pressing the F3 or F12 key. 
* You complete an operation on the Design display. 


You can use the following keys in the base operation. 


Chapter 13. Design Operation 235 


Table 53. Function Keys for Base Operation on the Design Display 


Key Function Description 

F3 Exit Exits the Design display. 

F4@ Sort Sorts the element list by the field on which the cursor is positioned. 
The fields which can be used to sort the list are NBR, NAME, 
ACROSS, and DOWN. 
This function cannot be used in the screen view. 

F6 Text Defines a text element. 

F9 Line Defines a line element. Press this key twice, to enter the start and 
end position. 

F10 Box Defines a box element. Press this key twice, to enter the start and 
end position. 

Fill Bar code Defines a bar code element. 

F13 Place Places a page segment, a graphic, or a record layout. Place the 
cursor at the desired position and press the F13 key. Then press the 
F6 key at the two opposite corners of a rectangle to place a graphic, 
the F9 key to place a page segment, or press the F11 key to place 
the record layout. 
You can place the record layout only when you are on the Design 
Page Layout display. 

Fl4 Change Changes an existing element. Place the cursor on the element's 
mark (or the element’s line in list view, and press the F14 key. 

F17 Switch view Switches the view back and forth between the screen view to the 
list view. 

F21 * Element edit Initiates the element edit operation. 

F22 * Block edit Initiates the block edit operation. 
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Table 54. Function Keys for Define or Change Operation on the Design Display 


Key Function Description 
F3 Exit Exits the define or change operation and returns to the 
base operation. 
F4 Detail Shows the Define or Change Detail display to enter more 
parameters. 
F6 Change Changes the measurement method between Row/Column 
measurement and Inch/Centimeter. 
method 
F12 Cancel Cancels the define or change operation and returns to the 


previous operation. The previous operation is: 


¢ The base operation if you are defining text or a bar 
code element, or changing an element. 

° The specifying end position if you are defining or 
changing a line element, box element, or graphics 
element. 

¢ The specifying end position if you are defining a line 
element or box element. 

F13 Repeat element Shows the Repeat element display to specify parameters 
for repeating the element. This function key cannot be 
used when changing a placed record on a page layout. To 
change the repetition of the placed record, use the F4 
(Detail) key. 


You can use the following function keys when you are placing a graphics element, 
a page segment, or a record layout: 


* Press the F13 key. 
Table 55. Function Keys for Place Operation on the Design Display 


Key Function Description 
F3 Exit Exits the place operation and returns to the base operation. 
F6 Place graphics Press this key twice to determine the size of the graphics data to 


be mapped. Then the key entry area will be displayed to enter 
the name of the graphics element. 


F9 Place page Displays the key entry area to enter the name of the page 
segment segment. 

Fill Place record Displays the key entry area to enter the parameters to place the 
layout record layout. 


You can use this function only when you are on the Design 
Page Layout display. 

F12 Cancel Cancels the place operation and returns to the previous 
operation. 


You can use the following function keys when you are editing an element or a 
block of elements: 


* Press the F21 key. 
* Press the F22 key twice. 


Table 56. Function Keys for Edit Operation on the Design Display 


Key Function Description 

F3 Exit Exits the edit operation and returns to the base operation. 

F6 Copy Copies the element or multiple elements to a desired position. 
F9 Move Moves the element or multiple elements to a desired position. 
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Table 56. Function Keys for Edit Operation on the Design Display (continued) 


Key Function Description 
F10 Remove Removes the element or multiple elements. 
F12 Cancel Cancels the place operation and returns to the previous 


operation. 


The previous operation is: 

* The base operation if you are defining a text or bar code 
element, or changing an element. 

* The place operation if you are placing a graphics element, 
page segment, or record layout. 

* The specifying end position if you are defining line element, 
box element, or graphics element. 


You can use the following function keys when you are specifying the end position: 


* Press the F6 key to specify the end position of a graphic. 


* Press the F9 key to specify the end position of a line. 


* Press the F10 key to specify the end position of a box. 


* Press the F22 key to specify the end position of a block. 


Table 57. Function Keys to Specify End Position on the Design Display 


Key Function Description 

F3 Exit Exits the specify end position display and returns to the base 
operation. 

F6 Graphics Specifies the end position if you pressed the F6 key before. 

F9 Line Specifies the end position if you pressed the F9 key before. 

F10 Box Specifies the end position if you pressed the F10 key before. 

F12 Cancel Cancels the specify end position display and returns to the 
previous operation. 

F22 Block edit Specifies the end position if you pressed the F22 key before. 
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Defining or Changing an Element 


In the screen view, you can define an element in the following steps. 


Step 1. 


Step 2. 


Step 3. 


Step 4. 


Move the cursor to the position where you want to place an element, or to 
the mark of the element to be changed on the image area. 

Press an appropriate function key assigned for the element. The possible 
function keys are shown below: 


Text F6 (Text) 

Line F9 (Line) 

Box F10 (Box) 

Bar Code F11 (Bar code) 

Graphics F13 (Place), then F6 (Graphics) 


Page Segment __F13 (Place), then F9 (Page segment) 
Record Layout —F13 (Place), then F11 (Record layout) 
Change (Any F14 

element) 


An element mark that begins with % is shown at the cursor position. 


When you define a line, a box, or a graphic, move the cursor to the end of 
the element, and press F6, F9, or F10 again. When you define other 
elements, this step is not needed. 


The key entry area appears. 


After these steps, the Overlay Utility and the Print Format Utility show 
the key entry area in the Design display. The key entry area overrides the 
lower part of the image area. See the following description for each 
parameter in the key entry area and detailed information according to the 
type of the element: 


Text 

Line 

Box 

Bar code 
Page segment 
Graphics 
Record layout 
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Step 5. 


Design Overlay Columns: 


Control . . Source overlay ..... STATIONERY 


Define Text 


Makes cs ho ae STOO Measurement method... . 


POSMETON, =) a. ws Across 32 Down 2 
Text data 


F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 


1- 74 


More... 


Row/Column 


4 


The key entry area format depends on the element type to be defined. In 
the previous display, the Overlay Utility and the Print Format Utility 
assign the element mark to this element and display it at the previous 
cursor position on the image area. The Overlay Utility and the Print 
Format Utility move the cursor to the appropriate input field on the key 


entry area. 


For all the element types, you are asked to complete all mandatory 
parameters in the key entry area to complete the element definition. 


Type the values for the parameters. 


The Overlay Utility and the Print Format Utility prompt you to type the 
mandatory parameters to create the element. For example, on the display 
shown above, you need to type the text data; This is an example. as 


shown in the Text data prompt in the following display. 


Design Overlay Columns: 


Control . « Source overlay ..... STATIONERY 


elope chirayece lM ictcncnactis sues Cuoteveus thionate sel Oieietatartaciers icy overs matiaratere Ol oneseiuah exevore Olstere, catieretaredh opeiers 


Define Text 
Markee cc fee ee ee LOOT Measurement method ....: 
POSTtETON i s o4 ions: os Across 32. Down 2 
Text data ... . This is an example. 


F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 


Row/Column 


More... 
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To change an element created previously, place the cursor at the element 
mark. Then use the change function by pressing the F14 key. The same 
display as the one to create the element is displayed on the image area, 
except that the previously entered parameters appear in their appropriate 


fields. 


The following parameters are common to all elements in this display: 


Field Name Description 

Mark The element mark is displayed in this field. It could be either a 
system-assigned mark or a user-assigned name. 

Measurement This field shows the measurement method used to specify the 

method position. You may change this field by pressing the F6 key. 

Position The position parameter consists of across and down values. These 


values specify the horizontal and vertical position of the element being 
defined. Possible values for each measurement method in this field 
are: 


Measurement Method Possible Value Range 
Inches 0 to 22.75 

Centimeters 0 to 57.79 

Row/Columns 1 to 999 


Note: The possible value range depends on the size of the overlay or 
the page layout. If the size is smaller than the values, the overlay or 
page layout size is the maximum possible value. 


The Overlay Utility and the Print Format Utility check the specified 
values to make sure the element is completely contained in the 
overlay, the record layout, or the page layout by referring to the page 
size which was previously defined in the overlay specifications or the 
PFD specifications. If you press the F6 key to change the addressing 
from the current value to another, the values of this field will be 
changed to the appropriate values for the new unit of measure as 
accurately as possible by the Overlay Utility and the Print Format 
Utility. 


The element display position in the image area will be moved to the 
new position if you change the value in this field. 


In addition to the parameters shown above, depending on the element 
type, you need to enter the mandatory parameters. 


Step 6. Define the specifications. 


By pressing the F4 key, you can also more precisely specify an element by 
adding more parameters. 
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Step 7. Complete the definition by pressing the Enter key. 


Finally, the defined element appears on the image area as shown in the 
following display. 


_ 


Design Overlay Columns: 1- 74 
Control .. Source overlay ..... STATIONERY 


002 *T001 s an example. 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 


Repeat the above steps to define the rest of the elements. 


Step 8. After you define all the elements, press the F3 key to save the overlay, the 
record layout, or the page layout. 


Text 

To create a text element, press the F6 (Text) key and the key entry area appears in 
the lower position of the display as follows. This display also appears by pressing 
the F14 key to change a text element. When you press Enter, the Overlay Utility 
and the Print Format Utility check the validity of the entered parameters. If errors 
do not exist, the operation is completed and the key entry area disappears from the 
display. 


By pressing the F4 (Detail) key, you can define the detailed characteristics of the 
text element. 
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Control 


Marek: +... 


Text data 


F3=Exit 
F12=Cancel 


Ns 


Source overlay ..... STATIONERY 


. iSeries Stationery Co., Ltd. 


F4=Detail 


F24=More keys 


Design Overlay Columns: 1- 74 


%T0Q01 s an example. 


More... 
Change Text 
Measurement method . . . . : Row/Column 
32 Down 2 


F6=Change measurement method 


The following table explains each field in this display. 


Field Name Description 
Control You can move the list view window by entering one of the following 
commands in this field and pressing Enter. 
n Backward 
The image area moves n lines toward the top line of the 
overlay, the record layout, or the page layout. 
+n Forward 
The image area moves n lines toward the bottom line of the 
overlay, the record layout, or the page layout. 
W-n Left 
The image area moves n columns toward the first column of 
the overlay, the record layout, or the page layout. 
W+n Right 
The image area moves n columns toward the last column of 
the overlay, the record layout, or the page layout. 
n The image area moves to the nth line. 
Wn The image area moves to the nth column. 
*TOP The image area moves to the top line. 
*BOT The image area moves to the bottom line. 
Mark The element mark is displayed in this field. It could be either a 
system-assigned mark or a user-assigned name. 
Measurement This field shows the measurement method used to specify the position. 
method You may change this field by pressing the F6 key. 
Position The position parameter consists of across and down values. These 


values specify the horizontal and vertical position of the element being 


defined. 
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Field Name Description 


Text data You can enter the text data in this field or update the previously 
entered text data that is displayed in this field. You can enter up to 58 
characters. If you need to enter more than 58 characters of text data, 
press F4 (Detail) to enter the Define Text Detail display. 


If the previously defined text data is longer than 58 characters, three 
periods (...) will be displayed at the end of this field. It means that 
more text data exists. When executing on a DBCS system, DBCS data 
can be entered in this field. 


Press the Enter, F3, or F12 key to return to the Design Overlay display, or press the 
F4 key to specify more parameters. 


In the Define Text Detail display, you can specify more parameters for a text 
element if you need to define it more precisely. For example, you can specify the 
character font and color for the text element. The Overlay Utility and the Print 
Format Utility check the specified values to make sure the element is completely 
contained in the overlay, the record layout, or the page layout by referring to its 
page size, which was previously defined in the overlay specifications or the PFD 


specifications. 
( Change Text Detail * 
Mark: *T001 Measurement method: Row/Column 
Type choices, press Enter. 
Position: 
‘AGVOSS: fesuet ssc cece ova ence 32 1-999 
DOWNS. 04 cso. wey ee ah ave tee Jot Z 1-999 
MOXte data ce wsmesy bets ene er es iSeries Stationery Co., Ltd. 
EMemenite ec ceesass aise peonsais cet a Name 
Oia a caecart ec poe hier meaner 1 1=Horizontal, 2=Vertical 
Degree of rotation. .... 0 0, 90, 180, 270 
COMOG flees as tues ae ee ee *DEFAULT *DEFAULT, 1=Blue, 2=Red 
3=Magenta, 4=Green, 5=Cyan 
6=Yellow, 7=Brown, 8=Black 
Widerhing: tas 660656) m8 N Y=Yes, N=No 
Ovensitriker ss. ccc. een ene Character 
ROMU SS Sota) es wise geese ae es ae *DEFAULT *DEFAULT, 1-8, F4 for list 
More... 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method 
F1Q=Edit numeric F12=Cancel 
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( Change Text Detail *) 
Mark: *T001 Measurement method: Row/Column 
Type choices, press Enter. 
Character size: 
Width Sate ear *DEFAULT *DEFAULT, 0.10-99.99 
Hei Gites sexe <=. ces vat fer se cents *DEFAULT *DEFAULT, 0.10-99.99 
Bottom 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method 
F10=Edit numeric F12=Cancel 
eA 
Field Name Description 
Mark Shows the element mark. A mark is either a system-assigned mark or 
a user assigned-name, and is the same as that shown on the display. A 
mark is six characters long, the first character is an asterisk (*), and the 
last character is a blank. The middle four characters are: 
¢ For a system-assigned mark, the middle four characters are one 
character for the element type followed by a three-digit sequence 
number. For text elements, the element type is T and the sequence 
number is 001 to 999. 

¢ For a user-assigned name, the middle four characters are the four 
characters specified as the value for the element name. 

Measurement Shows the measurement method used to specify position. You can 

method change this value by pressing F6. You can also select centimeters or 
inches for the measurement unit in the Define Overlay Specifications 
display or in the Define PFD Specifications display by specifying unit 
of measure. 

Position The position parameter consists of across and down values. These 
values specify the horizontal and vertical position of the element being 
defined. 

Text data Specify your text data in this field. Text data can be up to 203 bytes in 


length. If you need to enter or update text data that is more than 203 
bytes in length, you have to define it as multiple text elements. 


For a record layout of the printout format definition (PFD definition), 
you can enter a database field name. For example, a field name 
PRODCT is specified as "&PRODUCT" You can see the list of fields 
and select one of them by placing the cursor in the Text data prompt 
and pressing the F4 key. 


You can also specify reserved variable data in a record wen and a 


page layout, and summary data in a page layout. See 
43 for more information. 


Note: You can enter only one line of text for a text element. To enter 
multiple lines of text, use a box element or multiple text elements. 
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Field Name 


Description 


Element 


Format 


Degree of rotation 


Color 


Specify the element name in this prompt. 


An element name is 1 to 4 characters in length. If an element name is 
specified (not blank) for an element, the element mark is displayed as 
an asterisk (*) followed by the element name. It is not an asterisk (*) 
followed by the element type and three-digit sequence number. 
Specifies the printing direction of the text. Specify one of the following 
values: 


Horizontal 
Characters are printed from left to right. 


Vertical 
Characters are printed vertically from top to bottom. Vertical 
lines of text are printed from left to right. 


Vertical, right to left 
Characters are printed vertically from top to bottom. Vertical 
lines of text are printed from right to left, as the Japanese 
traditional way of formatting. This is the same meaning as 
Vertical when there is only one line of text. This choice 
appears when you are using DBCS data in the file for which 
you specified Y (Yes) for the User specified DBCS data prompt. 
The Right to Left option does not apply on a non-DBCS 


system. 
See EST | for examples of formatting. 


Notes: 

1. You can enter only one line of text for a text element. To enter 
multiple lines of text, use a box element or multiple text elements. 

2. Not all printers support the vertical format. You cannot enter 2 
(Vertical) or 3 (Vertical right to left) if the printer does not support 
the vertical format. 

3. To use 2=Vertical or 3=Vertical right to left, you should be aware of 
the following: 
* If your printer type is 1, you cannot use these formats. 
¢ If your printer type is 2 or 3, you must specify font type 2 or 3. 


¢ If your printer type is one of the others, no restrictions apply. 
Specifies the degrees of rotation of the text in terms of an angle 
measured clockwise from the overlay, page layout, or record layout. 
The default value is 0. 
Specifies the color used to print the text. The default value is 
*DEFAULT,; the printer default color. 


Notes: 


1. Not all printers support color printing. You cannot enter a value in 
the Color prompt if the printer does not support color printing. 

2. If the printer does not support the color you select, an error occurs 
or a default color is used when this text is printed. You should 
check which colors are supported on the printer. 

3. To use values other than *DEFAULT and 8=Black, you should be 
aware of the following: 

* Your printer type must be 1 or 9, and your printer must be able 
to print the specified color. 
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Field Name 


Description 


Underline 


Overstrike 


Font 


DBCS font 


Specifies whether or not text is printed with an underline. 
Y (Yes) An underline is printed. 
N (No) No underline is printed. 


An underline starts at the beginning of the text data, which includes 
leading blanks and blanks between characters if they exist. An 
underline stops at the end of the text data. 


Notes: 


1. Not all printers support this function. You are not allowed to enter 
the value if the printer does not support this function. 


2. To use underline, you should be aware of the following: 
* If your printer type is 4, 5, or 6, you must specify font type 1 or 
3. 


* If your printer type is one of the others, there are no restrictions. 
Specifies a single SBCS character in the Overstrike prompt to type over 
on all characters in the defined text data including blank character(s). 
If DBCS characters exist in that text, the characters are not typed over. 


Notes: 


1. Not all printers support this function. You are not allowed to enter 
the value if the printer does not support this function. 


2. To use overstrike, you should be aware of the following: 
¢ If your printer type is 4, 5, or 6, you must specify font type 1 or 
3. 


* If your printer type is one of the others, there are no restrictions. 
Specifies a font number. A font number is 1 to 8, and *DEFAULT. A 
number or *DEFAULT is defined in the Work with Source Overlay 
Fonts or the Work with PFD Definition Fonts display. You can see the 
list of fonts and select one of them by placing the cursor in this field 
and pressing F4. 


Notes: 


1. The program does not verify that the specified font exists and is an 
SBCS font. If the font does not exist, some errors may occur when 
this text is printed. If you specify a DBCS font, the result is 
unpredictable. Some unexpected characters may be printed, or 
some errors may occur. 


2. *DEFAULT no longer indicates to use the default font of the 
printer. When *DEFAULT is different from what you want, change 
it on the Work with Source Overlay Fonts display or the Work with 
PFD Definition Fonts display. 

Specifies a font number. A font number is 1 to 8, and each number is 

defined in the Work with Source Overlay Fonts or the Work with PFD 

Definition Fonts display. You can see the list of fonts and select one of 

them by placing the cursor in this field and pressing F4. This prompt 

appears when you are using DBCS data in the file for which you 
specified Y (Yes) for the User specified DBCS data prompt. 


Note: It is not checked if the specified font exists and is a DBCS font. 
If it does not exist, some errors may occur when this text is printed. If 
you specify a SBCS font, the result is unpredictable. Some unexpected 
characters may be printed, or some errors may occur. 
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Field Name 


Description 


Character size 


Width 


Height 


Specifies the character width and character height to be printed. 


Note: When you use values other than *DEFAULT, the values impact 
performance. You also should be aware of the following: 


* If your printer type is 4, 5, or 6, you can not specify this parameter. 
¢ If your printer type is 2 or 3 you must specify font type 1. 


¢ If your printer type is one of the others, there are no restrictions. 
Specifies each character’s width. When the measurement method is 
Row/Column, you can specify the multiplier of the character width 
which was specified as Characters per inch in the overlay 
specifications or the PFD specifications. Otherwise, you can specify the 
character width in that measurement method, that is, the unit of 
measure in the overlay specifications or the PFD specifications. The 
printer prints the overlay text data with either enlarged or reduced 
characters. The default value *DEFAULT indicates that the font is used 
as is and no enlarging or reducing is performed. 


The character width is measured by its font box width. The origin of 
the character font is set at the bottom left corner of the font box. 


Notes: 


1. Not all printers support this function, and this prompt is not 
displayed if the printer you specify does not support this function. 


2. If the value you specify is too small for the 4224 printer, the 4234 

printer, and the 4230 printer, the text is not printed correctly. 
Specifies each character’s height. When the measurement method is 
Row/Column, you can specify the multiplier of the character height 
which was specified as Characters per inch in the overlay 
specifications or the PFD specifications. Otherwise, you can specify the 
character height in that measurement method, that is, the unit of 
measure in the overlay specifications or the PFD specifications. The 
printer prints the overlay text data with either enlarged or reduced 
characters. The default value *DEFAULT indicates that the font is used 
as is and no enlarging or reducing is performed. 


The character height is measured by its font box height. The origin of 

the character font is set at the bottom left corner of the font box. 

Notes: 

1. Not all printers support this function, and this prompt is not 
displayed if the printer you specify does not support this function. 

2. If the value you specify is too small for the 4224 printer, the 4234 
printer, and the 4230 printer, the text is not printed correctly. 


When you press Enter, the Overlay Utility and the Print Format Utility check the 
validity of the entered parameters. If no errors are detected, the text element will 
be defined and the Design display will be displayed. 


Font Selection: You can show the Select Source Overlay Font display or the Select 
PFD Definition Font display by positioning the cursor in the Font or the DBCS font 
prompt and pressing the F4 (Prompt) key. 


You can select a font to use from the list. The fonts are defined in the Work with 
Source Overlay Fonts display and in the Work with PFD Definition Fonts display. 
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Select Source Overlay Font 


Type option, press Enter. 


1=Select 
Font 
Opt Number Text 

*DEFAULT 10 CPI Courier 
1 10 CPI Courier 
2 10 CPI Courier 
3 10 CPI Courier 
4 10 CPI Courier 
5 10 CPI Courier 
6 10 CPI Courier 
7 10 CPI Courier 
8 10 CPI Courier 


Bottom 
F5=Refresh  F12=Cancel 


7 


This display shows the list of source overlay fonts or PFD definition fonts. You can 
select a font by typing 1 in the Opt column next to the Font Number column and 
pressing Enter. 


The following table explains each field in this display. 


Field Name Description 

Opt Specify a 1 to specify a source overlay font or PFD definition font. 
Font Number Shows the font number. 

Text Shows the description of the font. 


You may specify a 1 in the Opt column, then press Enter. Now you return to the 
previous display. 


Line 

To specify a line element, first move the cursor to the start position of the line and 
press the F9 key to define a line element. A mark %Lnnn (where nnn is 001 through 
999) appears at the start position. 


Move the cursor to the end position of the line element and press the F9 key again. 
The key entry area will appear at the lower part of the image area. Start and end 
positions that were previously identified by the cursor are displayed. A line image 
also appears to show the start and end positions on the image area. 

To change a line element, move the cursor to the mark of the line and press the 


F14 (Change) key. The key entry area will appear at the lower part of the image 
area. 
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Control 


Mark 
Start position . 
End position . . 


F3=Exit 
F12=Cancel 


SS 


: *LQ02 
. Across 
. Across 


F4=Detail 
F24=More keys 


Columns: 1- 74 


STATIONERY 


Design Overlay 
Source overlay 


Mic rea this vosce Lieven tein cos 2 ccene acters dea Diersiva teres wAllere ose thersea s Diary ene tars evs Ole, avere Pace eal vczie. 


More... 

Define Line 
Measurement method 
Down 5 
Down 5 


. . . . 2 Row/Column 


19 
50 


F6=Change measurement method 


The following table explains each field in this display. 


Field Name 


Description 


Control 


Mark 
Measurement method 


Start position 


You can move the list view window by entering one of the following 


commands in this field and pressing Enter. 


n Backward 
The image area moves n lines toward the top line of the 
overlay, the record layout, or the page layout. 

+n Forward 
The image area moves n lines toward the bottom line of the 
overlay, the record layout, or the page layout. 

W-n Left 
The image area moves n columns toward the first column of 
the overlay, the record layout, or the page layout. 

Wn Right 
The image area moves n columns toward the last column of 
the overlay, the record layout, or the page layout. 

n The image area moves to the nth line. 

Wn The image area moves to the nth column. 

*TOP The image area moves to the top line. 

*BOT The image area moves to the bottom line. 


The element mark is displayed in this field. It could be either a 
system-assigned mark or a user-assigned name. 

This field shows the measurement method used to specify the 
position. You may change this field by pressing the F6 key. 


The position parameter consists of across and down values. These 


values specify the horizontal and vertical start position of the 
element being defined. 
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Field Name Description 


End position The position parameter consists of across and down values. These 
values specify the horizontal and vertical end position of the element 
being defined. 


Press the Enter, F3, or F12 key after you specify the parameters, or press the F4 key 
to specify more parameters. 


By pressing the F4 key, the following display appears to specify those 
characteristics. 


r >) 


Define Line Detail 


Mark: *L002 Measurement method: Row/Column 
Type choices, press Enter. 


Start position: 


ACKOSSi cat ea et cr ateteahe 19 1-999 
DOWNY se: <2 Stee <e. cek cee Ser se aes 5i 1-999 
End position: 
INCKOS Siecuen ears hora eset re 50 1-999 
DOWN reo cs sas cee fox Get cet en cen cee 5 1-999 
Ekemenite 3 Scuase tates ects der Name 
Inemty pes “sc ee eee odes ns 1 1=Solid, 2=Dashed, 3=Dotted 
Mime WIEN: seo es ec ee es *MEDIUM *NARROW, *MEDIUM, *WIDE 
0.00-1.00 
Line placement. ...... if 1=Middle, 2=Border 


Bottom 
F3=Exit F5=Refresh F6=Change measurement method  F12=Cancel 
Ae / 
The following table explains each field in this display. 
Field Name Description 
Mark Shows the element mark. A mark is either a system-assigned mark or 


a user assigned-name, and is the same as that shown on the display. A 
mark is six characters long, the first character is an asterisk (*), and the 
last character is a blank. The middle four characters are: 


¢ For a system-assigned mark, the middle four characters are one 
character for the element type followed by a three-digit sequence 
number. For line elements, the element type is L and the sequence 
number is 001 to 999. 


* For a user-assigned name, the middle four characters are four 
characters specified as the value for the element name. 

Measurement Shows the measurement method used to specify positions. You can 

method change this value by pressing F6. You can also select centimeters or 
inches for the measurement unit in the Define Overlay Specifications 
display or the Define PFD Specifications display by specifying unit of 
measure. 

Start position The position parameter consists of across and down values. These 
values specify the horizontal and vertical start position of the element 
being defined. 

End position The position parameter consists of across and down values. These 
values specify the horizontal and vertical end position of the element 
being defined. 
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Field Name 


Description 


Element 


Line type 


Line width 


Line placement 


Specifies the element name that appears on the image area instead of a 
regular line element mark, such as *LO01. The default value is blank 
which is to display the regular element mark. 

Specifies the type of line used to draw the box on the printer. 


1 Solid line _ 
2 Dashed line - - - - - 
3 Dotted line..... 


The default value is 1 (Solid line). 
Specifies the width of line used to draw the line on the printer. 


*NARROW 1/120 inch 
*MEDIUM 1/60 inch 


*WIDE 1/40 inch 
n If the unit of measure specified in the specification is inch, n 
is 0.00 - 1.00 otherwise n is 0.00 - 2.54. 


Specifies the placement of the line. This parameter is used only when 
the measurement method is Row/Column. 


1 Middle 
Line is drawn in the middle of character cells. 


2 Border 
Horizontal line is drawn at the top of character cells. Vertical 
line is drawn at the left of character cells. 


The default value is 1 Middle. 


Press Enter, the F3, or F12 key after you specify the parameters. The Design 
display will be displayed. 


Box 


The following display appears by pressing the F10 key at the diagonal points for a 
box element definition, or by pressing the F14 key to change a box element. 


When you press Enter, the Overlay Utility and the Print Format Utility check the 
validity of the entered parameters. If no errors exist, the operation is completed 
and the key entry area disappears from the display. 
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Control 


011 
012 


F3=Exit 
F12=Cancel 
Ne 


Define Box 
Marikeegrcwees cass ac BOOR Measurement method . . . . : Row/Column 
Start position . . Across D, Down 4 


End position. . 


F4=Detail F6=Change measurement method 
F24=More keys 


Design Overlay Columns: 1- 74 
Source overlay ..... STATIONERY 


More... 


. Across 60 Down 10 


The following table explains each field in this display. 


Field Name Description 
Control You can move the list view window by entering one of the following 
commands in this field and pressing Enter. 
-n Backward 
The image area moves n lines toward the top line of the 
overlay, the record layout, or the page layout. 
+n Forward 
The image area moves n lines toward the bottom line of the 
overlay, the record layout, or the page layout. 
W-n Left 
The image area moves n columns toward the first column of 
the overlay, the record layout, or the page layout. 
Wn Right 
The image area moves n columns toward the last column of 
the overlay, the record layout, or the page layout. 
n The image area moves to the nth line. 
Wn The image area moves to the nth column. 
*TOP The image area moves to the top line. 
*BOT 
The image area moves to the bottom line. 
Mark The element mark is displayed in this field. It could be either a 
system-assigned mark or a user-assigned name. 
Measurement This field shows the measurement method used to specify the 
method position. You may change this field by pressing the F6 key. 


Start position 


The position parameter consists of across and down values. These 
values specify the horizontal and vertical start position of the element 
being defined. 
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Field Name Description 


End position 


The position parameter consists of across and down values. These 


values specify the horizontal and vertical end position of the element 
being defined. 


Press Enter, the F3, or F12 key after you specify the parameters, or press the F4 key 


to specify more parameters. 


When you press the F4 key, the following display appears. You can specify further 
details of the box element. For example, you can specify the line type, the line 
width, the line placement, the shading pattern, and the shading type on this 


display. 
(~ Define Box Detail ) 
Mark:  *BQQ2 Measurement method: Row/Column 
Type choices, press Enter. 
Start position: 
AGKOSS# avon. a osc no eee ees 5 1-999 
DOWNS 24s ares ake seen tee ton oe 4 1-999 
End position: 
AChOSS aces ear cece Abeta one 60 1-999 
DOWN 4.008 cep xe, Xo ee tee oh oe 10 1-999 
Elemenity 02. atte water te sens Name 
SINGS EY DOS ea: eee es tae 1 1=Solid, 2=Dashed, 3=Dotted 
Lameswaidthy so ee een te Gan oe *MEDIUM *NARROW, *MEDIUM, *WIDE 
0.00-1.00 
Line placement. ...... 1 1=Middle, 2=Border 
More... 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method  F12=Cancel 
“e 4 
Press the Roll Up (Page Down) key to see the next page of the Define Box Detail 
display. 
(~ Define Box Detail ) 
Mark: *BQQ2 Measurement method: Row/Column 
Type choices, press Enter. 
Shading: 
Pattern: “i tae seuss ce os 1=Standard, 2=Screen 
HY PGs ven easel cer esy Rem neuter *MEDIUM *LIGHT, *MEDIUM, *DARK 
*HIGHLIGHT, 0.01-100.00 (%) 
Text: 
Textidata is.) scdvceis, cous 
More... 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method  F12=Cancel 
XX 4 


254 AFP Utilities for iSeries: User’s Guide 


Press the Roll Up (Page Down) key to see the next page of the Define Box Detail 


display. 
‘a Define Box Detail a 
Mark: *B002 Measurement method: Row/Column 
Type choices, press Enter. 
Text: 
FOVMate at eeehct cert mrc deers 1 1=Horizontal, 2=Vertical 
Placement: 
Hora zontal verre vse sneer wruesy ce 1 l=Left, 2=Center, 3=Right 
4=Balance 
VEVEVCON CS cn a: ws cee es we oe 1 1=Top, 2=Center, 3=Bottom 
Degree of rotation. .... 0 0, 90, 180, 270 
COO Trae take et ance een sor ane *DEFAULT *DEFAULT, 1=Blue, 2=Red 
3=Magenta, 4=Green, 5=Cyan 
6=Yellow, 7=Brown, 8=Black 
Underiine2ocoest. seer os bso bs N Y=Yes, N=No 
OVENSIERUKG2 eects wenasy scans oe Character 
FONtrespes ptog she, salcaesi testes *DEFAULT *DEFAULT, 1-8, F4 for list 
DBCS how a Aue we we wee 1-8, F4 for list 
More... 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method  F12=Cancel 
Ne eA 


Press the Roll Up (Page Down) key to see the next page of the Define Box Detail 


display. 
fa Define Box Detail >) 
Mark: *BOO2 Measurement method: Row/Column 
Type choices, press Enter. 
Character spacing: 
Horizontal . «. so a a we *CPI *CPI, 5.00, 10.00,, 12.80, 13.30 
15.00, 16.70, 18.00, 20.00 
Vertical «ios @ 2 <4 « *LPI *LPI, 3.00,.4.00, 6.00, 7.50 
8.00, 9.00, 12.00. 
Bottom 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method  F12=Cancel 
Ke / 
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The following table explains each field in this display. 


Field Name 


Description 


Mark 


Measurement 
method 


Start position 


End position 


Element 


Line type 


Line width 


Shows the element mark. A mark is either a system-assigned mark or 
a user assigned-name, and is the same as that shown on the display. A 
mark is six characters long, the first character is an asterisk (*) and the 
last character is a blank. The middle four characters are: 


¢ For a system-assigned mark, the middle four characters are one 
character for the element type followed by a three-digit sequence 
number. For box elements, the element type is B and the sequence 
number is 001 to 999. 

¢ For a user-assigned name, the middle four characters are four 
characters specified as the value for the element name. 

Shows the measurement method used to specify positions. You can 

change this value by pressing F6. You can also select centimeters or 

inches for the measurement unit in the Define Overlay Specifications 

display by specifying unit of measure. 

The position parameter consists of across and down values. These 

values specify the horizontal and vertical start position of the element 

being defined. 

The position parameter consists of across and down values. These 

values specify the horizontal and vertical end position of the element 

being defined. 

An element name is 1 to 4 characters in length. If an element name is 

specified (not blank) for an element, the element mark is displayed as 

an asterisk (*) followed by the element name. It is not an asterisk (*) 

followed by the element type and three-digit sequence number. 

Specifies the element name. 

Specifies the type of line used to draw the box on the printer. 


1 Solid line __ 
2 Dashed line - - - - - 
3 Dotted line..... 


The default value is 1 (Solid line). 
Specifies the width of line used to draw the box on the printer. 


*NARROW 1/120 inch 
*MEDIUM 1/60 inch 


*WIDE 1/40 inch 


n If the unit of measure specified in the specification is inch, n 
is 0.00 - 1.00 otherwise n is 0.00 - 2.54. 


If you specify 0 for this parameter, the text in the box is formatted and 
the box is not printed. If the measurement method of the text in the 
box is Row/Column, it is formatted according to the line placement 
parameter. 
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Field Name 


Description 


Line placement 


Shading Pattern 


Shading Type 


Specifies the placement of the line used to draw the box. This 
parameter is used only when the measurement method is 
Row /Column. 


1 Middle 
Lines are drawn in the middle of character cells. 


2 Border 
Upper horizontal line is drawn at the top of character cells, 
and lower horizontal line is drawn at the bottom of character 
cells. A left vertical line is drawn at the left of character cells, 
and a right vertical line is drawn at the right of character 
cells. 


The default value is 1 Middle. 
Specifies the pattern used to shade the box. 


1=Standard 
Standard shading pattern is used. 


2=Screen 
Screen shading pattern is used. 


1 for examples of the shading 


pattern. 


If you do not specify anything, the box is not shaded. 
Specifies the type of shading when the Shading pattern prompt is 
specified. 


*LIGHT 
Black is 24% and white is 76%. 


*MEDIUM 
Black is 48% and white is 52%. 


*DARK 
Black is 72% and white is 28%. 


*HIGHLIGHT 
The shaded area will be highlighted in color. The color used 
will be the highlighting color of the printer, but may be tinted 
to a deeper or lighter color. The Define Box Detail panel will 
be re-displayed to accept input for percent color and percent 
black. The sum of the two percent values cannot exceed 100 
percent. “HIGHLIGHT can only be selected for printer groups 
which support color highlighting or if the printer type is 
*DEFAULT and Y (yes) is selected for Color shading on the 
Confirm or Change Printer Attributes panel. When 
“HIGHLIGHT is selected for the Shading type, the shading 
pattern is always set to 1 (Standard). 


n The box is shaded n percent black, while n is a number 
between 0.01 and 100.00. 


The default value is *MEDIUM. This prompt is ignored when the 
Shading pattern prompt is not specified except when the Shading type is 
*HIGHLIGHT. 


See 
pattern. 


1 for examples of the shading 
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Field Name 


Description 


Text data 


Format 


Specify your text data in this field. Text data can be up to 203 bytes in 
length. If you need to enter or update text data that is more than 203 
bytes in length, you have to define it as multiple box elements or with 
text elements. 


For a record layout of the printout format definition (PFD definition), 
you can enter a variable data field as "&<field name>.”. You can see 
the list of fields and select one of them by placing the cursor in the 
Text data prompt and pressing the F4 key. 


You can also specify reserved variable data in a record ae and a 


page layout, and summary data in a page layout. See 


¥ for more information. 


You can specify two or more lines of text for text data in a box 
element. They are formatted according to the values specified for the 
Format and Text placement prompts. 


To specify multiple lines of text, you need to enclose each line of text 
with two apostrophes and one or more blanks between two 
apostrophes as follows: 


"ABC' 'DEF' 
This means that the first line is ABC and the second line is DEF. 


To specify apostrophes (’) in multiple-line text, specify two 
apostrophes for an apostrophe as follows: 
'Tom''s cap' ‘Jane''s car' ---> Tom's cap 
Jane's car 
Specifies the printing direction of the text. Specify one of the following 
values: 


Horizontal 
Characters are printed from left to right. 


Vertical 
Characters are printed vertically from top to bottom. Vertical 
lines of text are printed from left to right. 


Vertical, right to left 
Characters are printed vertically from top to bottom. Vertical 
lines of text are printed from right to left, as the Japanese 

traditional way of formatting. This choice appears when you 
are using a DBCS file. This option does not appear when the 
system is not DBCS capable. 


Notes: 


1. Not all printers support the vertical format. You are not allowed to 
enter 2 (Vertical) or 3 (Vertical right to left) if the printer does not 
support the vertical format. 


2. To use 2=Vertical or 3=Vertical right to left, you should be aware of 
the following: 


* If your printer type is 1, you can not use these formats. 
* If your printer type is 2 or 3, you must specify font type 2 or 3. 
* If your printer type is one of the others, there are no restrictions. 
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Field Name Description 


Text placement: Specifies how the text is positioned in the box. 
Horizontal 
sie a 1 (Left) All lines of text are left aligned. 
2 (Center) 
The following two spaces have the same width. 
¢ Between left vertical line of box and the first character of 
the text 
° Between right vertical line of box and the last character of 
the text 


3 (Right) 
All lines of text are right aligned. 


4 (Balance) 
The spaces between each character and both vertical lines of 
the box have the same width. This is valid only when the 
Format is horizontal. 


The default value is 1 (Left). 


Text Specifies how the text is positioned in the box. 


1 t: Vertical 
[eee terme. (Top) The first line of text is positioned just below the top 


horizontal line of box. 


2 (Center) 
The following two spaces have the same length. 
* Between top horizontal line of box and the first line of the 
text 
¢ Between bottom horizontal line of box and the last line of 
the text 


3 (Bottom) 
The last line of text is positioned just above the bottom 
horizontal line of box. 


4 (Balance) 
The spaces between each character and both vertical lines of 
the box have the same width. This is valid only when the 
Format is vertical. 


The default value is 1 (Top). 


page 419 for examples. 

Degree of rotation Specifies the degrees of rotation of the text in terms of an angle 
measured clockwise from the overlay, page layout, or record layout. 
The default value is 0. 
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Field Name 


Description 


Color 


Underline 


Overstrike 


Font 


Specifies the color used to print the text. The default value is 
*DEFAULT. It is the printer default color. 


Notes: 

1. Not all printers support the color printing function. You are not 
allowed to enter a value in the Color prompt if the printer does not 
support color printing. 

2. If the printer does not support the color you select, an error occurs 
or a default color is used when this text is printed. You should 
check which colors are supported on the printer. 

Specifies whether or not text is printed with an underline. 


Y (Yes) An underline is printed. 


N (No) No underline is printed. 


An underline starts at the beginning of the text data, which includes 
left blank characters and blanks between characters if they exist. An 
underline stops at the end of the text data. 


Notes: 


1. Not all printers support this function. You are not allowed to enter 
the value if the printer does not support this function. 


2. To use underline, you should be aware of the following: 
* If your printer type is 4, 5, or 6, you must specify font type 1 or 
3. 


* If your printer type is one of the others, there are no restrictions. 
Specifies a single SBCS character in the Overstrike prompt to type over 
on all characters in the defined text data including blank character(s). 
If DBCS characters exist in that text, the characters are not typed over. 


Notes: 


1. Not all printers support this function. You are not allowed to enter 
the value if the printer does not support this function. 


2. To use overstrike, you should be aware of the following: 
* If your printer type is 4, 5, or 6, you must specify font type 1 or 
3. 


* If your printer type is one of the others, there are no restrictions. 
Specifies a font number. A font number is 1 to 8, and *DEFAULT. Each 
number or *DEFAULT is defined in the Work with Source Overlay 
Fonts or the Work with PFD Definition Fonts display. You can see the 
list of fonts and select one of them by placing the cursor in this field 
and pressing F4. See bad for details. 


Notes: 


1. It is not checked if the specified font exists and is a SBCS font. If it 
does not exist, some errors may occur when this text is printed. If 
you specify a DBCS font, the result is unpredictable. Some 
unexpected characters may be printed, or some errors may occur. 

2. *DEFAULT no longer indicates to use the default font of the 
printer. When *DEFAULT is different from what you want, change 
it on the Work with Source Overlay Fonts display or the Work with 
PFD Definition Fonts display. 
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Field Name 


Description 


DBCS font 


Character spacing 
(Horizontal) 


Character spacing 
(Vertical) 


Specifies a font number. A font number is 1 to 8, and each number is 
defined in the Work with Source Overlay Fonts or the Work with PFD 
Definition Fonts display. You can see the list of fonts and select one of 
them by placing the cursor in this field and pressing F4. See bas for 
details. 


Note: It is not checked if the specified font exists and is a DBCS font. 
If it does not exist, some errors may occur when this text is printed. If 
you specify a SBCS font, the result is unpredictable. Some unexpected 
characters may be printed, or some errors may occur. 

The data specified in the Horizontal prompt is used for calculating the 
horizontal space that the characters of Text data occupy in a box 
element. 


When the measurement method is Row/Column, specify *CPI, 5.00, 
10.00, 12.00, 13.30, 15.00, 16.70, 18.00, or 20.00. 


When the measurement method is Inch, specify *CPI or the value in 
inches from 0.01 to 22.75. 


When the measurement method is Centimeter, specify *CPI or the 
value in centimeters from 0.01 to 57.79. 


The default value is *CPI which is the same value as Characters per 
inch on the Define Overlay Specifications display or on the Define 
PFD Specifications display. 


The value specified in horizontal applies only to SBCS fonts. The 
character space size of DBCS fonts is extracted from the font resource 
on the iSeries system. If DBCS data is contained in the text data and 
the font resource cannot be accessed when creating an overlay or 
printing a database file member, the text data formatting in the box 
may not be correct. 

The data specified in the Vertical prompt is used for calculating the 
vertical space that the characters of Text data occupy in a box element. 


When the measurement method is Row/Column, specify *LPI, 3.00, 
4.00, 6.00, 7.50, 8.00, 9.00, or 12.00. 


When the measurement method is Inch, specify *LPI or the value in 
inches from 0.01 to 22.75. 


When the measurement method is Centimeter, specify *LPI or the 
value in centimeters from 0.01 to 57.79. 


The default value is *LPI which is the same value as Lines per inch on 
the Define Overlay Specifications display or on the Define PFD 
Specifications display. 


The value specified in Vertical applies to only SBCS fonts. The 
character space size of DBCS font is extracted from the font resource 
on the iSeries system. If DBCS data is contained in the text data and 
the font resource cannot be accessed when creating an overlay or 
printing a database file member, the text data formatting in the box 
may not be correct. 
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Formatting Examples: 


Table 58. Formatting examples 
Horizontal Characters are printed from left to right. The following shows an 
example: 
| The first line. | 
The second line. 
The third line. 


Vertical Characters are printed vertically from top to bottom. Vertical 
lines of text are printed from left to right. The following shows 
an example: 


Vertical, right to left Characters are printed vertically from top to bottom. Vertical 
lines of text are printed from right to left, as the Japanese 
traditional way of formatting. This is the same meaning as 
Vertical when there is only one line of text. This choice appears 
when you are using DBCS data. The following shows an 
example. 


On the Define Box Detail display, type the choices and press Enter, the F3, or F12 
key after you specify the parameters. The Design display will be displayed. 
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Bar Code 


You can initiate the define bar code operation by pressing F11 (Bar code) or the 
change bar code operation by pressing the F14 key with the cursor at a bar code 
element mark. The key entry area appears replacing the lower part of the image 
area as shown in the following display. 


y 


Control 


001 
002 
003 
004 


Position 


F3=Exit 
F12=Cancel 


S 


Pe Graee ctrievesaresMsavenaroctiescrars Gsuatere tiers ede Siceererochectanese Gl aterevathsanatel) ierecrestisrenerelOlaralere tresses) sessises 


se 3° ¥C002 Measurement method . . . . : Row/Column 
. . . Across 10 Down 4 Bar code type... 


Mayiki ve verve, 


Bar code data 


F4=Detail F6=Change measurement method 
F24=More keys 


> 


Design Overlay Columns: 1- 74 
Source overlay ..... STATIONERY 


More... 
Define Bar Code 


The following table explains each field in this display. 


Field Name Description 
Control You can move the list view window by entering one of the following 
commands in this field and pressing Enter. 
n Backward 
The image area moves n lines toward the top line of the 
overlay, the record layout, or the page layout. 
+n Forward 
The image area moves n lines toward the bottom line of the 
overlay, the record layout, or the page layout. 
W-n Left 
The image area moves n columns toward the first column of 
the overlay, the record layout, or the page layout. 
W+n Right 
The image area moves n columns toward the last column of 
the overlay, the record layout, or the page layout. 
n The image area moves to the nth line. 
Wn The image area moves to the nth column. 
*TOP The image area moves to the top line. 
*BOT The image area moves to the bottom line. 
Mark The element mark is displayed in this field. It could be either a 
system-assigned mark or a user-assigned name. 
Measurement This field shows the measurement method used to specify the 
method position. You may change this field by pressing the F6 key. 
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Field Name 


Description 


Position 


Bar Code Type 


Bar Code Data 


The position parameter consists of across and down values. These 
values specify the horizontal and vertical position of the element being 
defined. 

This field specifies the type of the bar code, including the version if 
applicable. The following bar code types are available: 


Type __ Description 

3-of-9 code, MHI/ AIM USD-3 

MSI 

UPC/CGPC-Version A 
UPC/CGPC-Version E 

EAN-8 (includes JAN-short) 

EAN-13 (includes JAN-standard) 
2-of-5 Industrial 

2-of-5 Matrix 

Interleaved 2-of-5 (MHI/AIM USD-1) 
Codabar (MHI/AIM USD-4). 
Code128 (AIM USS-128) 

POSTNET (Postal Numeric Encoding Technique) 
RMASCC (Royal Mail Bar Code) 
JPBC (Japan Postal Bar Code) 


oO mn Dn Tt FF YO NY 


re oe ee 
BP WN FO 


15 Australian Postal 
Whether or not a set of characters or data length is valid depends on 
the bar code type. 


You can enter the bar code data in this field, or update the previously 
entered bar code data that is displayed in this field. You can enter it 
up to a length of 58 characters. If you need to enter more than 58 
characters of bar code data, press F4 (Detail) to enter the Define Bar 
Code Detail display. 


If the previously defined bar code data is longer than 58 characters, 
three periods (...) will be displayed at the end of this field. It means 
that more bar code data exists. 


Pressing Enter validates the entered parameters. If they are valid, the 
define or change takes place. Then the define bar code operation 
completes and the key entry area disappears from the display. 


If the data entered does not match the bar code specification, an error 
message appears on the bottom of the display, the data field image is 
reversed and the operation does not take place. See for more 
information. 


Press the Enter, F3 or F12 key after you specify the parameters, or press the F4 key 
to specify more parameters. 


By pressing the F4 key, the following display appears. You can specify further 
details of the bar code element. 
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Note: The content of the Change Bar Code Detail display varies depending on the 


bar code type, and not all types of bar codes provide all of the following 


prompts on the display. 


(~ Define Bar Code Detail =) 
Mark: *C002 Measurement method: Row/Column 
Type choices, press Enter. 
Position: 
INGCOS Scaremicanoncucs enc aeeee 10 1-999 
DOWNSeeec orc gsystancuseesesiyeees 4 1-999 
Bar *COdG=type™ ices) ee vex «<0 3 1=CODE30F9, 2=MSI, 3=UPC-A 
4=UPC-E, 5=EAN-8, 6=EAN-13 
7=INDUST25, 8=MATRIX25 
9=INTERL25, 10=CODABAR 
11=CODE128, 12=POSTNET 
13=RM4SCC, 14=JPBC 
15=AUSTRALIAN POSTAL 
Bar’ code data... 40.6 <3 a 12345678901 
Bement: is evr, se cee as vce Name 
More... 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method  F12=Cancel 
oe a 
Press the Roll Up (Page Down) key to see the next page of the Define Bar Code 
Detail display. 
(~ Define Bar Code Detail > 
Mark:  »*C002 Measurement method: Row/Column 
Type choices, press Enter. 
Character supplement .... @ O25. 5 
Offset: 
ACKOSSmrctecte seen eaten ce Number 
Degree of rotation. .... 0 0, 90, 180, 270 
Golo oe ca Ges, eee os *DEFAULT *DEFAULT, 1=Blue, 2=Red 
3=Magenta, 4=Green, 5=Cyan 
6=Yellow, 7=Brown, 8=Black 
Checked Giiteges crnsn cores te cane N Y=Yes, N=No 
LRAT iecpemec cy vate tanicie ee are ice 3 1=Below, 2=Above, 3=No 
HRT aSterisikies keen caves eons N Y=Yes, N=No 
HR TeROnties. ce: cece cen ap cones bay ee *DEFAULT *DEFAULT, 1-8, F4 for list 
Module: width: 4.156% css, % *DEFAULT *DEFAULT, 0.001-0.254 
Element height. ...... *DEFAULT *DEFAULT, 0.01-22.75 
Wide to narrow ratio.... *DEFAULT *DEFAULT, 2.00-3.00 
Bottom 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method  F12=Cancel 
S wy 
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The following table explains each field in this display. 


Field Name 


Description 


Mark 


Measurement 
method 


Position 
Bar code type 


Bar code data 
Element 


Character 
supplement 


Shows the element mark. A mark is either a system-assigned mark or a 
user assigned-name, and is the same as that shown on the display. A 
mark is six characters long, the first character is an asterisk (*), and the 
last character is a blank. The middle four characters are: 


° For a system-assigned mark, the middle four characters are one 
character for the element type followed by a three-digit sequence 
number. For bar code elements, the element type is C and the 
sequence number is 001 to 999. 


* For a user-assigned name, the middle four characters are four 
characters specified as the value for the element name. 

Shows the measurement method used to specify position. You can 

change this value by pressing F6. You can also select centimeters or 

inches for the measurement unit in the Define Overlay Specifications 

display or the Define PFD Specifications display by specifying unit of 

measure. 

Specifies the horizontal and vertical positions of the bar code. 

Specifies the name of the bar code including the version if applicable. 

Bar code types are as follows: 


Type — Description 

3-of-9 code, MHI/ AIM USD-3 

MSI 

UPC/CGPC-Version A 
UPC/CGPC-Version E 

EAN-8 (includes JAN-short) 

EAN-13 (includes JAN-standard) 
2-of-5 Industrial 

2-of-5 Matrix 

Interleaved 2-of-5 (MHI/ AIM USD-1) 
Codabar (MHI/AIM USD-4) 
Code128 (MIM USS-128) 

POSTNET (Postal Numeric Encoding Technique) 
RMA4SCC (Royal Mail Bar Code) 
JPBC (Japan Postal Car Code) 


AUSTRALIAN POSTAL 
Note: Not all printers support all bar codes. 


oO mn nua F&F WO NY 


ee ee ee ee or 
a 8 Ww N FO 


This field specifies the bar code data. See for more information. 
This field specifies the element name that will appear on the image area 
instead of the regular bar code mark. The default value is blank to 
display the regular element mark. 

Specifies the character supplement. You can specify one of 0, 2, or 5 asa 
character supplement. Supplement is supported by type 3, 4, or 6 only. 
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Field Name 


Description 


Offset 


POSTNET type 


Degree of rotation 


Color 


Check digit 


HRI 


HRI asterisk 


Specifies the offset of the start position of supplement characters from 
the start position of the bar code in the unit of measure specified in the 
overlay specifications or the PFD specifications. 


The default value varies depending on the printer type. If you leave this 
prompt blank, the default value for the printer type is used. 

This prompt is displayed when POSTNET is specified as the bar code 
type. It specifies the symbolic type of POSTNET. The valid bar code data 
length depends on this value. The allowable types are as follows : 


1 ZIP Code (5 digits) 

2 ZIP+4 (9 digits) 

3 Advanced bar codes (11 digits) 

4 Variable length data (up to 100 digits) 


The default value = 1. 

Specifies the degrees of rotation of the bar code symbol in terms of an 
angle measured clockwise from the overlay, the page layout, or the 
record layout. The default value is 0. 

This field specifies the color of the bar code symbol and HRI. The 
default value is *DEFAULT which specifies the printer default. 


Notes: 


1. Not all printers support the color printing function. You are not 
allowed to enter a value in the Color prompt if the printer does not 
support the color printing. 

2. If the printer does not support the color you select, an error occurs 
or a default color is used when this bar code is printed. You should 
check which colors are supported on the printer. 

3. To use values other than *DEFAULT and 8=Black, you should be 
aware of the following: 

* Your printer type must be 1 or 9, and your printer must be able to 
print the specified color. 

This field specifies a check digit algorithm to be used. Valid values vary 

depending on the bar code type. See B72] for more information. 


This field specifies where to place the Human Readable Interpretation 
(HRI). 


1 Place the HRI below the bar code symbol. 
2 Place the HRI above the bar code symbol. 
3 Place no HRI. 


Note: This value is ignored by the printer depending on the bar code 
type. For example, 


* When the bar code type supports only one type of HRI position. 
¢ When the bar code type requires HRI. 
This field specifies whether to print an asterisk or not. 


Y An asterisk is printed in an HRI for 3-of-9 code as start and 
stop bar and space patterns. 


N An asterisk is not printed in an HRI for 3-of-9 code as start and 
stop bar and space patterns. 


The default value is N. 
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Field Name 


Description 


HRI font 


Module width 


Element height 


Wide to narrow 
ratio 
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You can specify an HRI font with a font number between 1 and 8. The 
actual font used for the number has been defined on the Work with 
Source Overlay Fonts display or the Work with PFD Definition Fonts 
display. The default value is *DEFAULT which specifies the printer 
default when the printer type which supports a bar code is specified. 
For the printer types which do not support the Bar Code Object Content 
Architecture, the following code pages and the character sets are used 
for *DEFAULT: 


* Codel28 


Code page 
T1V10500 


Character set 
COSOCR1O 


* UPCA, UPCE, EAN8, EAN13 


Code page 
T1V10500 


Character set 
COLOOBOA 


* Others (Except for POSTNET) 


Code page 
T1V10500 


Character set 
COLOOAOA 


Specifies the module width. A module is the smallest-defined bar code 
dimension. 


A valid value for this prompt is *DEFAULT or a number in the unit of 
measure specified in the overlay specifications or the PFD specifications. 
The range of valid values is 


* 0.001 - 0.254 (in inches) 
* 0.003 - 0.645 (in centimeters) 


The range of valid module widths varies depending on the bar code 
type and application. The default value is *DEFAULT. 

Specifies the height of the symbol bar and space elements. A valid value 
is *DEFAULT or a number in the unit of measure specified in the 
overlay specifications or the PFD specifications. The range of valid 
values is 


* 0.01 - 22.75 (in inches) 
* 0.01 - 57.79 (in centimeters) 


For the UPC, CGPC, EAN and JAN bar code types, the total symbol 
height includes both bar and space patterns and HRI. The default value 
is *DEFAULT. 

Specifies the ratio of the Bar Code wide-element dimension to the 
narrow-element dimension when there are only two different-size 
elements. The wide-to-narrow ratio is not applicable to the UPC or the 
EAN codes. The ratio for the MSI is always 2.00 regardless of the value 
specified in this prompt. If this prompt is left blank, the printer default 
value *DEFAULT is used. 


After you specify the parameters, press Enter, the F3, or F12 key. The Design 
display is displayed. 


Bar Code Data: The following explains the Bar code data prompt in detail. The 
valid set of characters and data lengths depend on the bar code type. 


For a record layout of the printout format definition (PFD definition), you can 
enter a variable data field as "&<field name>.”. You can see the list of fields and 
select one of them by placing the cursor in the Bar code data prompt and pressing 
the F4 key. The following shows valid characters and data lengths for each bar 
code type: 


* 3-of-9 code, MHI/AIM USD-3 
The following characters are valid. 


0123456789 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 
-.$/+% blank 


The length of data can be up to 100 characters. When you want to add trailing 
spaces, enclose the data with apostrophes as follows: 


"ABC ; 
Trailing space 
* MSI 
The following characters are valid. 
0123456789 


The length of data can be up to 15 characters for no check digit, up to 14 for 1 
check digit, and up to 13 for 2 check digits. Specify the check digit through the 
define bar code detail operation. The default is no check digit. 

* UPC/CGPC-Version A 
The following characters are valid. 
0123456789 


The length of data can be 11, 13, or 16 characters. The first digit is the 
number-system digit. The next 10 digits are the article-number digits. If the 
length of data is 13 characters, the last 2 digits are interpreted as the UPC 
two-character supplement. If the length of data is 16 characters, the last 5 digits 
are interpreted as the UPC five-character supplement. 

* UPC/CGPC-Version E 
The following characters are valid. 
0123456789 


The length of data can be 10, 12, or 15 characters. From the first 10 digits, the 
printer generates both the check digit and the six characters to be bar-coded. The 
check digit is not bar-coded. It is used only to assign odd or even parity to the 
six bar-coded digits. 


If the length of data is 12 characters, the last 2 digits are interpreted as the UPC 
two-character supplement. If the length of data is 15 characters, the last 5 digits 
are interpreted as the UPC five-character supplement. 


* EAN-8 (includes JAN-short) 
The following characters are valid. 
0123456789 
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The length of data can be 7 characters. 
* EAN-13 (includes JAN-standard) 

The following characters are valid. 

0123456789 


The length of data can be 12, 14, or 17 characters. The first 2 digits are two flag 
digits. The next 10 digits are the article-identification digits. The first flag digit is 
not bar-coded. The second flag digit that the article-identification digit and a 
check digit generated by the printer are bar-coded. 


If the length of data is 14 characters, the last 2 digits are interpreted as the EAN 
two-digit add-on. If the length of data is 17 characters, the last 5 digits are 
interpreted as the EAN five-digit add-on. 


* 2-of-5 industrial 
The following characters are valid. 
0123456789 


The length of data can be up to 100 characters. 
° 2-of-5 matrix 

The following characters are valid. 

0123456789 


The length of data can be up to 100 characters. 
¢ Interleaved 2-of-5 (MHI/AIM USD-1) 

The following characters are valid. 

0123456789 


The length of data can be up to 100 characters. 
* Codabar (MHI/AIM USD-4) 
The following characters are valid. 


0123456789 
-$:/.+ABCD 


The length of data can be up to 100 characters. The characters A, B, C, and D 
shall be used only as start and stop delimiters. 


* CODE128 

All ASCII 128 character set values are valid, and the data length is variable. 
* POSTNET 

The following characters are valid. 

0123456789 


You can specify the following POSTNET type: 
Table 59. POSTNET types 


1 ZIP Code (The maximum length is 5 digits) 
2 ZIP+4 (9 digits) 

3 Advanced bar codes (11 digits) 

4 Variable length data (up to 100 digits) 


* RM4SCC 
The following characters are valid. 
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0123456789 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 


The length of data can be from 5 to 12 characters. 


The Royal Mail Bar Code (RM45CC) consists of four parts; the International 
Prefix (optional), the Outward Code (required), the Inward Code (required), and 
the Delivery Point Suffix (optional). 


The International Prefix, when used, contains three numeric digits. 


The Outward Code contains from two to four characters in one of the following 
seven forms where A is alphabetic and N is numeric: 

ANA 

AAN 

AANN 

AANA 

AN 

ANN 

AAA 


The Inward Code contains one numeric character followed by two alphabetic 
characters. 


The Delivery Point Suffix, when used, contains one numeric digit followed by 
one alphabetic character other than C, I, K, M, O, and V. 


- JPBC 


The following characters are valid. 


0123456789 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 


The length of data can be from 7 to 50 characters. 


For additional information about JPBC bar code data, press the Help key with 
the cursor in the Bar code data prompt on the Define Bar Code or Change Bar 
Code display. For a complete set of rules, see the Japan Postal Bar Code 
Command Specifications. 
Australian Postal 
The following characters are valid: 

012346789 

# space 

ABCDEFGHIJKLMNOPORSTU VWXYZ 

abcdefghijklmnopqrstuvwxyz 


AFP Utilities support four customer bar code structures for Australian Postal: 


Standard Customer Bar Code Length 37 bars; no bars of customer information. 
Data length is 10. 


Reply Paid Bar Code Length 37 bars, no bars of customer information. 
Data length is 10. 


Customer Bar Code 2 Length 52 bars, 16 bars of customer information. 
Data length is from 10 to 18. 


Customer Bar Code 3 Length 67 bars, 31 bars of customer information. 
Data length is from 10 to 25. 
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Note: For additional information about 
Australian Postal bar code data, press the 
Help key with the cursor in the Bar code 
data prompt on the Define Bar Code or 
Change Bar Code display. 


Check Digit: The following explains the Check digit prompt in detail. 
° 3-of-9 code, 2-of-5 Industrial, 2-of-5 Matrix, Interleaved 2-of-5, Codabar. 


Y Generates a check character and prints it with the bar code. 
N Prints the bar code with no printer-generated check character. 


The default value is N. 
e MSI 


1 Prints the bar code with IBM modulo-10 check digit generated by the printer, and 
places this check digit at the end of the data. IBM modulo-10 check digit is the 
second check digit. 


2 Prints the bar code with both check digits generated by the printer, and places them 
at the end of the data. The first and second check digits are IBM modulo-10. 


3 Prints the bar code with both check digits generated by the printer, and places them 
at the end of the data. The first check digit is NCR modulo-11. The second check 
digit is IBM modulo-10. The remainder equals the check digit. A check digit of 10 is 
an error. 


4 Prints the bar code with both check digits generated by the printer, and places them 
at the end of the data. The first check digit is IBM modulo-11. The second check 
digit is IBM modulo-10. The remainder equals the check digit. A check digit of 10 is 
an error. 


5 Prints the bar code with both check digits generated by the printer, and places them 
at the end of the data. The first check digit is NCR modulo-11. The second check 
digit is IBM modulo-10. The remainder subtracted from 11 equals the check digit. A 
check digit of 10 is zero. 


6 Prints the bar code with both check digits generated by the printer, and places them 
at the end of the data. The first check digit is IBM modulo-11. The second check 
digit is IBM modulo-10. The remainder subtracted from 11 equals the check digit. A 
check digit of 10 is zero. 


7 Prints the bar code with both check digits generated by the printer, and places them 
at the end of the data. The first check digit is NCR modulo-11. The second check 
digit is IBM modulo-10. The remainder subtracted from 11 equals the check digit. A 
check digit of 10 is an error. 


8 Prints the bar code with both check digits generated by the printer, and places them 
at the end of the data. The first check digit is IBM modulo-11. The second check 
digit is IBM modulo-10. The remainder subtracted from 11 equals the check digit. A 
check digit of 10 is an error. 


N Prints the bar code with no printer-generated check character. 


The default value is N. 
¢ Others 
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For other bar code types, this field is ignored. A default value is not available. 
Page Segment 


Note: Some printers do not support IOCA image (of page segment). See IBM 
Printing Systems: Printer Information, (S544-5750), for detail. AFP Utilities 
support only IOCA function set 10. 


To specify a page segment in the overlay, first move the cursor to the start position 


of the page segment, and press F13 (Place). The following display appears. 
i Design Overlay Columns: 1- 74 . 
Control .. Source overlay ..... STATIONERY 
A aveueths sored asec evelsy rie nia vara chat nate'S ave. siarh sa) ain ievete sock cveieve Disrerotactiase cyulOievs stastianeveveddsecoiers 
001 
002 
003 
004 % 


More... 
F3=Exit F6=Place graphics F9=Place page segment F12=Cancel 
F24=More keys 
Press F6 or F9 to place graphics or page segment. 


Ns ee 


Press the F9 key to select the page segment to be placed. Then the % mark changes 
to the %Snnn (where nnn is 001 through 999) and the key entry area appears at the 


lower part of the image area as shown in the following display. 
(~ Design Overlay Columns: 1- 74 ) 

Control . . Source overlay ..... STATIONERY 

Feet oins leew PenceQeoste her endce cs tacee4encetenseDssustenesOorasheaeels ass 

001 

002 

003 

004 %S003 

005 

006 

007 

008 

009 

010 

011 

012 


More... 
Place Page Segment 
Mavakston cence soto 2k 003: Measurement method . . . . : Row/Column 
POSHETON ssc ae Across 10 Down 4 
Page Segment... Name 


F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 
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The following table explains each field in this display. 


Field Name 


Description 


Control 


Mark 
Measurement 


method 
Position 


Page Segment 


You can move the list view window by entering one of the following 
commands in this field and pressing Enter. 


n Backward 


The image area moves n lines toward the top line of the 
overlay, the record layout, or the page layout. 


+n Forward 


The image area moves n lines toward the bottom line of the 
overlay, the record layout, or the page layout. 


W-n Left 


The image area moves n columns toward the first column of 
the overlay, the record layout, or the page layout. 


W+n Right 


The image area moves n columns toward the last column of 
the overlay, the record layout, or the page layout. 


n The image area moves to the nth line. 
Wn The image area moves to the nth column. 
*TOP The image area moves to the top line. 


*BOT The image area moves to the bottom line. 

The element mark is displayed in this field. It could be either a 
system-assigned mark or a user-assigned name. 

This field shows the measurement method used to specify the position. 
You may change this field by pressing the F6 key. 

The position parameter consists of across and down values. These 
values specify the horizontal and vertical position of the element being 
defined. 

You need to enter the name of the desired page segment. Then press 
Enter to complete the place page segment operation. 


Press Enter, the F3, or F12 key after you specify the parameters, or press the F4 key 
to specify more parameters. 


By pressing the F4 key, the following display appears. You can enter the page 
segment name in the following display and complete the operation, or obtain the 
list of page segments by pressing the F4 key in the Page segment field. 


Note: The Overlay Utility and the Print Format Utility do not verify whether the 
page segment you specified exists in the resource library or not because the 


age segment does not need to exist at this time. See 
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4 for more information. 


( Place Page Segment Detail *) 
Mark: — *S003 Measurement method: Row/Column 
Type choices, press Enter. 
Position: 
INGHOSSite. sey ce see cer celeee ton tae os 10 1-999 
DOWN! eo ee ee OS 4 1-999 
Page segment. .......-. Name, F4 for list 
Element 2 ea acceces er co vee coe ces Name 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method  F12=Cancel 
Page segment name not specified. J 


The following table explains each field in this display. 


Field Name 


Description 


Mark 


Measurement method 


Position 


Page segment 


Shows the element mark. A mark is either a system-assigned mark 
or a user assigned-name, and is the same as that shown on the 
display. A mark is six characters long and the first character is an 
asterisk (*) and the last character is a blank. The middle four 
characters are: 


° For a system-assigned mark, the middle four characters are one 
character for the element type followed by a three-digit sequence 
number. For page segment elements, the element type is S and the 
sequence number is 001 to 999. 


* For a user-assigned name, the middle four characters are four 
characters specified as the value for the element name. 

Shows the measurement method used to specify position. You can 

change this value by pressing F6. You can also select centimeters or 

inches for the measurement unit on the Define Overlay Specifications 

display or the Define PFD Specifications display by specifying unit 

of measure. 

This field specifies the horizontal and vertical positions of the page 

segment element. 

Specifies a page segment name. By pressing F4 with the cursor in 

this field, the following display appears: 


* When you are designing a record layout, the Select Field in Record 
Format display appears to select a variable data field name from 
the field list of the database file. Then press the F11 key to show 
the Select Page Segment display to select an existing page segment 
object from the list. 


¢ When you are designing an overlay or a page layout, the Select 
Page Segment display appears to select an existing page segment 
object from the list. 


See "Select Page Segment” on the following page for the next 
operation. 
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Field Name Description 


Element Specifies the element name that appears on the image area instead of 
a regular page segment element mark, such as *S003. The default 
value is blank which is to display the regular element mark. 


Press Enter, the F3, or F12 key after you specify the parameters. The Design 
display will be displayed. 


Select Page Segment: When you are designing a record layout, the Select Field in 
Record Format display appears to select a variable data field name from the field 
list of the database file. If a variable field name is selected, the contents of the field 
will be substituted as the page segment name or will be mapped to a page 
segment name by the Specify Mapping Object Name function. 


eG a 


Select Field in Record Format 
Database file ...... :  MLTFMT 
[ibRaRys “Scale, ey iseyet ee ne SENDAI 
Record! Format. <4 2, % 2) IMETEMT. 
Type an option, press Enter. 
1=Select 
Opt Field Length Type Text 
AREA 8 C Area products developed 
PRICE 3 P Price of the product 
PRODCT 12 C Product name 
SIZE 4 P Size 
BOTTOM 
F5=Refresh F1l=Select Object F12=Cancel 
S oy 


Then press the F11 key to show the Select Page Segment display to select an 
existing page segment object from the list. 


When you are designing an overlay or a page layout, and you press F4 (Detail) in 
the Place Page Segment Detail display with the cursor in the Page segment prompt, 
the following display appears to select a page segment name. In the following 
display, you can select a page segment name by entering 1 in the Opt column and 
pressing Enter. 
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Select Page Segment 
Positttion: to: 2 3 a: cs ee ee os Starting characters 


Type option, press Enter. 


1=Select 
Page 
Opt Segment Library Text 
BEAR QGPL bear 


Bottom 
F5=Refresh  F12=Cancel 


‘S A 


The Select Page Segment display shows the list of page segments in the libraries in 
the library list. You can select a page segment by typing 1 in the Opt column next 
to the Page Segment column and pressing Enter. 


Note: The library name is not passed, and it is not guaranteed that the page 
segment is retrieved from the library. It depends _on the contents of the 


Table 60. Select Page Segment display fields 


Field Name Description 

Position to This prompt is used to go to a particular area in the list. Use to 
reposition the list, not to create a subset of the list. Choose from the 
following: 


*TOP Go to the top of the list. 
*BOT Go to the bottom of the list. 


Name or partial Name 
Specifies the name or partial name you want to go to in the 
list. The list is positioned to the first name beginning with 
the string specified. 


1=Select Specifies what page segment is used for a source overlay or a 
printout format definition (PFD definition). 

Opt Specify 1 to select a page segment. 

Page segment Shows the page segment name. 

Library Shows the library name in which the page segment resides. 

Text Shows you the description of the page segment. 


Specify Variable Page Segment: You can specify a variable page segment in a 
record layout. See for more 
information. 
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Graphics 


Note: Some printers do not support graphics. See IBM Printing Systems: Printer 
Information, (S544—5750), for detail. 


To specify a graphics element in the overlay, first move the cursor to the start 
position of the graphics element, and press F13 (Place). The following display 


appears. 
( Design Overlay Columns: 1- 74 » 
Control s... Source overlay ..... STATIONERY 
ieee ech eyeveras das ssrortisycratei2 aiera «ttherscere Oiaseiere tsvavere Al oceteretavelere Oiecerare tuayersre| Ole scavett ars! ccsil chalove 


[<} 
S 
5B 
oe 


More... 
F3=Exit F5=Refresh F6=Place graphics F9=Place page segment 
F12=Cancel Fl5=Mark on/off F16=Hide F24=More keys 

Press F6 or F9 to place graphics or page segment. 


a e 4 


Press the F6 key to select the graphics to be placed. The % mark changes to the 
%Gnnn (where nnn is 001 through 999) as follows: 


eo 5 


Design Overlay Columns: 1- 74 
Control a .: Source overlay ..... STATIONERY 


001 
002 
003 
004 %G003 


More... 
F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 
Specify opposite corner of graphics block and press F6 
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Move the cursor to the bottom-right corner of the graphics area to specify the size, 
and press the F6 key again. The key entry area appears at the lower part of the 
image area as shown in the following display: 


(~ Design Overlay Columns: 1- 74 >) 
Control Source overlay ..... STATIONERY 
Manse tere was Ueeranerotbiatersre 2 cnetapetravesarei a arerctectictaress iis toy evaitronatete) sscionestustencys Ole aiarectoverstathesanste 
001 
002 
003 
004 %@003----------------------------- + 
005 : : 
006 
007 
008 
More... 
Place Graphics 
Matike-cuectuspsassurs : *G003 Measurement method . . . . : Row/Column 
Start position . . Across 10 Down 4 
End position . . . Across 41 Down 14 
Source object type . 1=PC document, 2=File 
F3=Exit F5=Refresh F6=Change measurement method  F12=Cancel 
F15=Mark on/off Fl6=Hide F19=Left F20=Right 
ee e/ 


When you specify ’2=File’ as the source object type, the following display appears: 


‘a Design Overlay Columns: 1- 74 +) 

Control Source overlay ..... STATIONERY 

A geavettares eva Lieiaveroch evetarei2isietecetieror eel iene cc estesaavers ly overs aitiorarssow iorsravertin tere! Oiccerapett ate-cisl sae 

001 

002 

003 

004 %GQ03----------------------------- + 

005 : : 

006 

007 

008 

More... 
Place Graphics 

Maiko give) ae cee xs : *G003 Measurement method . . . . : Row/Column 

Start position . . Across 10 Down 4 

End position . . . Across 41 Down 14 

Source object type .2 1=PC document, 2=File 

Fllie=ae gs a Name 

aibRary Sos ees se *LIBL Name, *LIBL, *CURLIB 

Members, 8. 4. 605 te4 *FIRST Name, *FIRST 

F3=Exit F4=Detail F6=Change measurement method 

F12=Cancel F24=More keys 
ae SF 
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The following table explains each field in these displays. 


Field Name Description 


Control You can move the list view window by entering one of the following 
commands in this field and pressing Enter. 


n Backward 


The image area moves n lines toward the top line of the 
overlay, the record layout, or the page layout. 


+n Forward 


The image area moves n lines toward the bottom line of the 
overlay, the record layout, or the page layout. 


W-n Left 


The image area moves n columns toward the first column of 
the overlay, the record layout, or the page layout. 


W+n Right 


The image area moves n columns toward the last column of 
the overlay, the record layout, or the page layout. 


n The image area moves to the nth line. 
Wn The image area moves to the nth column. 
*TOP The image area moves to the top line. 


*BOT The image area moves to the bottom line. 


Mark The element mark is displayed in this field. It could be either a 
system-assigned mark or a user-assigned name. 

Measurement This field shows the measurement method used to specify the position. 

method You may change this field by pressing the F6 key. 

Start position The start position parameter consists of across and down values. These 


values specify the horizontal and vertical position of the upper left 
comer of the element being defined. 

End position The end position parameter consists of across and down values. These 
values specify the horizontal and vertical position of the lower right 
comer of the element being defined. 

Note: Start position and End position determine the size of the 
graphics data to be printed. The graphics data will be mapped to the 
size when printed. 

Source object type Type 1 (PC document) or 2 (File) to specify the source object type. 

Folder Specifies the folder name where the PC document resides. 

PC document Specifies the PC document name which contains the graphics data. 
Note: Folder and PC Document prompts replace File, Library, and 
member prompts when ’1=PC Document’ is selected as the Source 


object type. 
File Specifies the file name where the member resides. 
Library Specifies the library name where the file resides. 
Member Specifies the member name which contains the graphics data. 


Press Enter after you specify the parameters, press the F4 key to specify more 
parameters, or press F3 or F12 to cancel the operation. 


By pressing the F4 key, one of the following displays appears. You can enter the 
data in the following display and complete the operation, or obtain the list of the 
folders, the PC documents, the files, the libraries, or members by pressing the F4 
key in each field. 
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Note: The Overlay Utility and the Print Format Utility do not verify whether the 


name you specified exists in the resource library or not because the graphics 


does not need to exist at this time. It will be checked when an overlay is 
created or a database file is printed with the PFD definition. When you 
specify ‘1=PC Document’ as the source object type, then press F4, the 


following display appears: 


eC Place Graphics Detail . 
Mark: — *GQQ3 Measurement method: Row/Column 
Type choices, press Enter. 
Start position: 
ACROSS taicsase twiciace fo tei ene 10 1-999 
DOWMN reo dex aay rev o> Se~ <ee ees seh nee ae 4 1-999 
End position: 
ACROSSe 2 qcaiswetausicce terrier ce 41 1-999 
DOWMN cecn2s3 os ree cee ce ecmer seures ce 14 1-999 
Source object type. .... 1 1=PC document, 2=File 
ROG ha ctcentnete aie cer erae sane 
Name 
PCSCOCUMERG oa 40 bo) eek Name, F4 for list 
Elemenitteceeecoeses: eoctcn ss teks Name 
Degree of rotation. .... 0 0, 90, 180, 270 
FOMtrs:)ovcc. si wep vss cameu cess eyenos *DEFAULT *DEFAULT, 1-8, F4 for list 
Bottom 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method  F12=Cancel 
Se y/ 


When you specify ’2=File’ as the source object type, the following display appears: 


‘a Place Graphics Detail ) 
Mark: — *G0QQ3 Measurement method: Row/Column 
Type choices, press Enter. 
Start position: 
ACYOSS: 2m as 5 ee ee es 10 1-999 
DOWMNiGesecrseaetac ocr rear ee 4 1-999 
End position: 
ACYOSS: 2 we a we ee 41 1-999 
Downitececpeemrtneaccorse sn rates 14 1-999 
Source object type. .... Zz 1=PC document, 2=File 
Fsih@r eee ten ves Sees cv Mec Goo cence Name, F4 for list 
DRAG ar ees ure ieee oo *LIBL Name, *LIBL, *CURLIB 
Member 6 a ee we we *FIRST Name, *FIRST, F4 for list 
Element: <6 sae ec ue es Name 
Degree of rotation. .... 0 0, 90, 180, 270 
BOnteter apron tne tecaor es tomes *DEFAULT *DEFAULT, 1-8, F4 for list 
Bottom 
F3=Exit F4=Prompt F5=Refresh F6=Change measurement method  F12=Cancel 
ie oA 
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The following table explains each field in these displays. 


Field Name 


Description 


Mark 


Measurement 
method 


Start position 


End position 


Source object type 
Folder 

PC document 

File 

Library 

Member 

Element 


Degree of rotation 


Font 


Shows the element mark. A mark is either a system-assigned mark or 
a user assigned-name, and is the same as that shown on the display. 
A mark is six characters long and the first character is an asterisk (*) 
and the last character is a blank. The middle four characters are: 


¢ For a system-assigned mark, the middle four characters are one 
character for the element type followed by a three-digit sequence 
number. For graphics elements, the element type is G and the 
sequence number is 001 to 999. 


¢ For a user-assigned name, the middle four characters are four 
characters specified as the value for the element name. 

Shows the measurement method used to specify position. You can 

change this value by pressing F6. You can also select centimeters or 

inches for the measurement unit on the Define Overlay Specifications 

display or the Define PFD Specifications display by specifying unit of 

measure. 

The start position parameter consists of across and down values. 

These values specify the horizontal and vertical position of the upper 

left corner of the element being defined. 

The end position parameter consists of across and down values. 

These values specify the horizontal and vertical position of the lower 

right corner of the element being defined. 

Note: Start position and End position determine the size of the 

graphics data to be mapped. 

Type 1 (PC document) or 2 (File) to specify the source object type. 

Specifies the folder name where the PC document resides. 

Specifies the PC document name which contains the graphics data. 

Specifies the file name where the member resides. 

Specifies the library name where the file resides. 

Specifies the member name which contains the graphics data. 

Specifies the element name that appears on the image area instead of 

a regular graphics element mark, such as *G003. The default value is 

blank which is to display the regular element mark. 

Specifies the degrees of rotation of the graphics in terms of an angle 

measured clockwise from the overlay, page layout, or record layout. 

The default value is 0. 

Specifies a font number. Font can be specified as 1 to 8, or *DEFAULT. 

Each number or *DEFAULT is defined in the Work with Source 

Overlay Fonts or the Work with PFD Definition Fonts display. You 

can see the list of fonts and select one of them by placing the cursor 

in this field and pressing F4. 

Note: It is not checked if the specified font exists and is a SBCS font. 

If it does not exist, some errors may occur when this graphics element 

is printed. If you specify a DBCS font, the result is unpredictable. 

Some unexpected characters may be printed, or some errors may 

occur. 


Press Enter after you specify the parameters, press the F4 key to specify more 
parameters, or press F3 or F12 to cancel the operation. 


Select Field in Record Format (Graphics): If you press F4 (Detail) in the Place 
Graphics Detail display when the cursor is in the Folder, PC document, Library, File, 
or Member prompt, the following occurs: 
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Table 61. Select Field in Record Format (Graphics) 


Designing a Source Overlay or a 
Page Layout 


Designing a Record Layout 


Folder Not supported 

You can select a PC document on 
the Select Document display which 
shows the list of PC documents 
existing in the specified folder. 


PC document 


The Select Field in the Record 
Format display is displayed. 

The Select Field in Record Format 
display is displayed. You can switch 
to the Select Document display by 
pressing the F11 key. To return, 
press the F11 key again. 


File You can select a database file on the The Select Field in Record Format 
Select Database File display which _ display is displayed. You can switch 
shows the list of database files to the Select Database File display 
existing in the specified library. by pressing the F11 key. To return, 

press the F11 key again. 

Library Not supported The Select Field in Record Format 

display is displayed. 

Member You can select a member on the The Select Field in Record Format 
Select Database File member display is displayed. You can switch 
display which shows the list of to the Select Database File Member 
members existing in the specified display by pressing the F11 key. To 
library and file. return, press the F11 key again. 

fa Select Field in Record Format = 

Database file: a... 4 v8 MLTFMT 
EDGR Ys ae dee ence vee SENDAI 
Record: Format: citi a. tas. 8 MLTFMT 
Type an option, press Enter. 
1=Select 
Opt Field Length Type Text 
AREA 8 Cc Area products developed 
PRICE 3 P Price of the product 
PRODCT 12 C Product name 
SIZE 4 P Size 
BOTTOM 
F5=Refresh F1l=Select Object F12=Cancel 

Ne Be 

Specify Variable Graphics: You can specify a variable graphics element in a 

record layout. See g g for more 

information. 
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Record Layout 
To specify a record layout in the page layout, first move the cursor to the position 


of the record layout, and press F13 (Place). The following display appears. 
(~ Design Page Layout Columns: 1- 74 - 

Control .. PED definitions.) « PRODUCTLBL 

Mra carertiacaccte:Merayasoterexaie' wiereteteereraie iajetcvert: srsvare Gy ccnkeie Tie varereid storeys arstove Ocesiniettianes ccd vectors 

001 

002 

003 

004 

005 % 

006 

007 

008 

009 

010 

011 

012 

013 

014 

015 

016 

017 


More... 
F3=Exit F6=Place graphics F9=Place page segment 
Fll=Place record layout F12=Cancel F24=More keys 
Press F6, F9 or Fll for graphics, page segment or record layout. 


‘S 


Press the F11 key to select the record layout to be placed. The % mark changes to 
%Rnnn-001 (where nnn is 001 through 999) and the key entry area appears at the 
lower part of the image area shown in the following display. 


(e Design Page Layout Columns: 1- 74 >) 
Control s..¢ PFD definition . .. « . PRODUCTLBL 
Miers coh eveveverdas susrortis crate stares tersters Oiaietere tr scayere occ rove ttea siege Wiersrarostuavercte! Ole ssavett ais !ecsil shalove 
001 
002 


005 %RO01-001 


More... 
Place Record Layout 
MaKe ie csp cen ee ao Sem ee ROOM Measurement method . . . . : Row/Column 
POSiitaone 2: Ge Antec s Across ] Down 5 


F3=Exit F4=Detail F6=Change measurement method 
F12=Cancel F24=More keys 
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The following table explains each field in this display. 


Field Name Description 


Control You can move the list view window by entering one of the 
following commands in this field and pressing Enter. 


n Backward 
The image area moves n lines toward the top line of the 
overlay, the record layout, or the page layout. 

+n Forward 
The image area moves n lines toward the bottom line of 
the overlay, the record layout, or the page layout. 

W-n Left 
The image area moves n columns toward the first column 
of the overlay, the record layout, or the page layout. 

Wen Right 
The image area moves n columns toward the last column 
of the overlay, the record layout, or the page layout. 

n The image area moves to the nth line. 

Wn The image area moves to the nth column. 

*TOP The image area moves to the top line. 

*BOT The image area moves to the bottom line. 

Mark The element mark is displayed in this field. It could be either a 


system-assigned mark or a user-assigned name. 
Measurement method This field shows the measurement method used to specify the 
position. You may change this field by pressing the F6 key. 
Position The position parameter consists of across and down values. These 
values specify the horizontal and vertical positions of the element 
being defined. 


Press Enter, the F3, or F12 key after you specify the parameters, or press the F4 key 


to specify more parameters. 


By pressing the F4 key, the following display appears. 
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Position: 
Across . 
Down. . 

Element . 

Direction 


Across . 
Down. . 
Distance: 
Across . 
Down. . 


SS 


Mark:  »*ROQ1 


Type choices, press Enter. 


Repetition: 


F3=Exit F4=Prompt F5=Refresh F6=Change measurement method  F12=Cancel 


Place Record Layout Detail 


Measurement method: Row/Column 


EP eS Te Ler. cone 5 1-999 
ep tawsvy ae ash een ei ass oats 5 1-999 
be Hitec: oenee rian Name 
Cae eo arene Zz 1=Across, 2=Down 
Pan ities eee i 1-99 
Ha Pe TP eRe 1 1-99 
Bernie eer es 1-999 
SE ue ene ie) We eocshest vs 1-999 


ov 


From this display, you can specify further detail characteristics of the place record 
element. For example, you can specify the direction, repetition, and distance. 


Field Name 


Description 


Mark 


Measurement 
method 


Position 
Element 


Shows the element mark. A mark is either a system-assigned mark or a user 
assigned-name, and is the same as that shown on the display. A mark is six 
characters long and the first character is an asterisk (*) and the last character 
is a blank. The middle four characters are: 


° For a system-assigned mark, the middle four characters are one character 
for the element type followed by a three-digit sequence number. For 
record elements, the element type is R and the sequence number is 001 to 
999, 


* For a user-assigned name, the middle four characters are four characters 
specified as the value for the element name. 


Note: Because the record layout may be placed repeatedly, when it is placed 
on the page layout, each mark for record layouts is followed by a repetition 
number from 001 to 999. 

Shows the measurement method used to specify position. You can change 
this value by pressing F6. You can also select centimeters or inches for the 
measurement unit in the Define PFD Specifications display by specifying 
unit of measure. 

Specifies the horizontal and vertical positions of the record layout. 

An element name is 1 to 4 characters in length. If an element name is 
specified (not blank) for an element, the element mark is displayed as an 
asterisk (*) followed by the element name. 
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Field Name _ Description 


Direction Records can be repeated in two directions. Select one of the following for 
the direction: 
1 Across (from left to right first and then from top to bottom.) The 
following is an example: 
Record 1 Record 3 Record 5 
Record 2 Record 4 Record 6 
2 Down (from top to bottom first and then from left to right.) The 
following is the example: 
Record 1 Record 3 Record 5 
Record 2 Record 4 Record 6 
Repetition Specifies how many times records are repeated on the page horizontally. 
Across 
Repetition Specifies how many times records are repeated on the page vertically. 
Down 
Distance Specifies the horizontal distance between records. 
Across 
Distance Specifies the vertical distance between records. 
Down 


The following figure shows the position and the distance of the record in the page 
layout. 
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Position-Down 


<?+—____+ a 
Kasiéiens [Record 2] [Record 3 Ae 
Across 


Distance- 
Across 


Figure 20. Position and Distance of the Record in the Page Layout 


Press Enter, the F3, or F12 key after you specify the parameters. You return to the 
Design display. 


Copy, Move, and Remove an Existing Element 


In the screen view, you can copy, move, or remove the existing elements on the 
image area. 


Element Edit 

You can copy, move, or remove a single element through the element edit 

operation. The following example explains how to copy an element. 

Step 1. Scroll the window to display the element to be edited. 

Step 2. Place the cursor at the element mark to be edited. 

Step 3. Press the F21 key to begin the element edit operation. In the following 
example, *T001 is selected as the element for the element edit. The asterisk 
(*) changes to a percent (%) to show the source element, and the function 
keys for the element edit appear at the lower part of the image area as 
follows. 


_ 


Design Overlay Columns: 1- 74 
Control . . Source overlay ..... SAMPLE 
Wiereattperatere ere: svecte care: ol2sorerarect avenste Sinre tote Tiare ccreAh ciate ech eiers<ci Die sneroet ote, eie/Olstare.tctiore: srsdeaerere 
001 
002 
003 
004 
005 
006 %TQ01 s an example. 
007 
008 
009 
010 
011 
012 
013 
014 
015 
016 
017 
More... 
F3=Exit F6=Copy F9=Move F10=Remove 
F12=Cancel F1l9=Left F2Q=Right F24=More keys 
Specify destination, press F6, F9, or F10. 
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Step 4. 


Step 5. 


To remove the element, press F10. To copy or move the element, move the 
cursor to the position where the selected element is to be copied (or 
moved). Page up or down to position the screen if necessary. 


To copy or move the element, press one of the following function keys: 


Copy F6 
Move F9 


The element is copied, moved, or removed, and the element edit operation 
is complete. 


y 


Design Overlay Columns: 1- 74 
Control x. Source overlay ..... SAMPLE 
Weg a theisceis Leis webiste V2 ee sre tictess Oiveiesetae sive ccee Piece cols vie.c the siete Olaeee Meise eV cieiess 
001 
002 
003 
004 


006 *T001 s an example. 


009 *T002 s an example. 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 
One element copied. 


‘S / 


Block Edit 

You can copy, move, or remove multiple elements in a rectangular area at one time 
with the block edit function. The elements displayed without an element mark or 
hidden under the other elements can also be edited by this function. The following 
example explains how to copy, move, or remove the elements: 


Step 1. 
Step 2. 


Step 3. 


Scroll the window to display the elements to be edited. 


Place the cursor at one corner of the rectangular area that contains the 
elements to be edited. 


Press the F22 key to begin the block edit operation and specify one corner 
of the rectangular area. A % sign appears at the cursor position. 
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Design Overlay Columns: 1- 74 


Control . . Source overlay ..... SAMPLE 


% 


*T001 s an example. 


*T002 s an example. 


More... 


F3=Exit F5=Refresh  F12=Cancel F15=Mark on/off 


F16= 


Hide F19=Left F20=Right F22=Block edit 


Specify opposite corner of block and press F22. 


J 


Step 4. Move the cursor to the opposite corner of the rectangular area. Scroll the 
window if necessary. 


Note: 


The lines, boxes, and graphics need to be completely contained in 
the rectangular area. The element types need only to have the 
starting position (the asterisk part) of the element mark within the 
rectangular area. 


Step 5. Press the F22 key again to specify the other corner of the rectangular area. 
The area is enclosed by equal (=) signs. The equal signs can overlay any 
element. The % mark shows the origin of the area to be copied, moved, or 
removed. 


Design Overlay Columns: 1- 74 


Control .. Source overlay ..... SAMPLE 


016 
017 


Recreate ayers Lies stethinraiorsiZovorarect eeserain cious th aete, eAycrotsresh sietevc Die aero trerecate Olscarerecticnare led aierece 


*T001 s an example. 


*T002 s an example. 


More... 


F3=Exit F6=Copy F9=Move F10=Remove 


F12= 


Cancel F19=Left F2Q=Right F24=More keys 


Specify destination, press F6, F9, or F10. 
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Step 6. To remove the elements, press F10. To copy or move the elements, move 
the cursor to the corner of the destination area which is the same corner 
as the origin of the area to be copied or moved. This can be any corner of 
the rectangular area. Scroll the window if necessary. 

Step 7. Press one of the following function keys to copy or move the elements in 
the rectangular area. 


Copy F6 
Move F9 


The elements in the rectangular area are copied, moved, or removed. 


If the F6 key is pressed the following display appears. 
a 


~ 


Design Overlay Columns: 1- 74 
Control .. Source overlay ..... SAMPLE 


006 *TQO01 s an example. 


009 *T002 s an example. 


013 *T003 s an example. 


016 *T004 s an example. 


More... 
F3=Exit F6=Text F9=Line F10=Box 
Fll=Bar code F21=Element edit F22=Block edit F24=More keys 
2 elements copied. 


Changing Elements in the List View 


In addition to the screen view, the Overlay Utility and the Print Format Utility 
have the list view to define an element. You can easily change between the list 
view and the screen view by pressing the F17 key. 


In the list view, you can see and change all the element definitions. The list view is 
useful for making minor changes to the elements that are already defined in the 
overlay, the record layout, or the page layout. The list view can also be used to 
create new elements. Creating new elements may be easier to do in the screen view 
which shows an approximate image. 


Layout of the List View 


The list view can display up to 16 elements at a time. To display more elements, 
scroll the window vertically. Each element shows up to 44 characters in the 
parameter field. To display the rest of the parameter field, scroll the window 
horizontally. The parameter field contains only the mandatory parameters for each 
element. To display or change other parameters, go to the Change Detail display 
by placing the cursor on the line of the element and pressing the F14 key, then the 
F4 key. 
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The following shows an example of the list view display. 


a Design Overlay ‘> 
Control «. Source overlay ..... STATIONERY 
NBR ID NAME M ACROSS DOWN Parameters 
O01 Ff 1 32 2 FONT=0 iSeries Stationery Co., Ltd. 
002 T 1 19 4 FONT=0 Standard Stationery Supply List 
003 =L 1 19 5 END ACROSS= 50 END DOWN = 5 
004 B 1 5 7 END ACROSS= 60 END DOWN = 26 
005 L 1 5 24 END ACROSS= 60 END DOWN = 24 
006 L 1 5 22 END ACROSS= 60 END DOWN = 22 
007 L 1 5 20 END ACROSS= 60 END DOWN = 20 
008 L* 1 5 18 END ACROSS= 60 END DOWN = 18 
009 L 1 5 16 END ACROSS= 60 END DOWN = 16 
010 L 1 5 14 END ACROSS= 60 END DOWN = 14 
Q11 L 1 5 12 END ACROSS= 60 END DOWN = 12 
012 2L 1 5 10 END ACROSS= 60 END DOWN = 10 
O13) CF Z 0.7 1.83 FONT=0 Ball Point Pen 
014 T PEN 1 pd 13 FONT=0_ Pencil 
015 T 1 7 15 FONT=0 _ Eraser 
016 T 1 7 17 FONT=0 Ruler 
More... 
F3=Exit F4=Sort F6=Text F9=Line 
F10=Box Fl1l=Bar code F13=Place F24=More keys 
2 y 
The following table explains each field in this display. 
Field Name Description 
Control You can move the list view window by entering one of the following 


commands in this field and pressing Enter. 


n 


+n 


W+n 


Backward 

The list moves n lines toward the top line. 

Forward 

The list moves n lines toward the bottom line. 

Left 

The Parameters column moves n columns toward the left. 
Right 

The Parameters column moves n columns toward the right. 
The line moves to the nth line. 

The Parameters column moves to the nth column. 

The list moves to the top line. 

The list moves to the bottom line. 


Note: When *TOP or *BOT is in the Control field, function 
keys are disabled. 


When designing an overlay, a simulated printout of the overlay can be 
displayed on the workstation. See the Control field Help for further 
information and restrictions. 


*VIEW A simulated printout of the overlay will be displayed. This 


function is not available when designing record layouts and 
page layouts. 
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Field Name 


Description 


NBR 


ID 


NAME 


ACROSS 


DOWN 


This is a sequence number field. The elements’ sequence numbers are 
listed in ascending order unless the list has been sorted by NAME, 
ACROSS, or DOWN fields. Also, this field is used to enter element edit 
commands. 

This is the element type field. If the element is temporarily removed by 
the remove element operation, an asterisk appears in the second 
character position. No input is allowed in this field. 

This is an element name field. This field holds up to 4 characters of the 
element name that you assigned. If the element does not have a name, 
this field is left blank. No input is allowed in this field. 

This field shows the two measurement methods used to specify the 
position. 


1 Row/Column is used. 


2 Inch or centimeter is used. 

No input is allowed in this field. 

This is the horizontal position of the element. If the M column is 1 
(Measurement method is Row/Column), this column has an integer 
value between 1 and 999. 


If the M column is 2 (Measurement method is inch or centimeter), this 
field has one of the following values depending on the unit of measure 
specified on the Define Overlay Specifications display or the Define 
PFD Specifications display: 


Inch 0 to 22.75 


Centimeter 

0 to 57.79 
Note: The maximum value depends on the size of the overlay or the 
page layout. 


No input is allowed in this field. 

This is the vertical position of the element. If the M column is 1 
(Measurement method is Row/Column), this column has an integer 
value between 1 and 999. 


If the M column is 2 (Measurement method is inch or centimeter), this 
field has one of the following values depending on the unit of measure 
specified on the Define Overlay Specifications display or the Define 
PFD Specifications display: 


Inch 0 to 22.75 


Centimeter 

0 to 57.79 
Note: The maximum value depends on the size of the overlay or the 
page layout. 


No input is allowed in this field. 
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Field Name 


Description 


Parameters 


Displayed parameters depend on the element type. These parameters 
are needed for each element: 


Text 


The font value is displayed. For SBCS systems, the value is displayed 
as "FONT=F", where F is 0 for the default font or 1 - 8 for a specified 
font local ID. For text elements on DBCS systems, the value is 
displayed as "SBCS FONT=F" if the element does not have a DBCS 
font specified, and "SBCS FONT=F DBCS FONT=F" if the element 
does have a DBCS font specified. The text data is displayed after the 
font value. There are three spaces between the font value and the 
first text character. 


Line 
End position is displayed. 
Box 


End position is displayed. If text is specified with the box, the font 
value and the text are also displayed after the end position. 


Bar code 


If HRI is to be printed, the HRI font value is displayed. The bar code 
data follows the font value. There are three spaces between the font 
value and the bar code data. 


Page segment 

Page segment name is displayed. 
Graphics 

End position is displayed. 
Record layout 

None. 


No input is allowed in this field. You can display other parameters 
when you change the element on the Change Detail display. 


Create or Change the Element 


You can not enter or change parameters directly on the list. However, you can 
define new elements or change existing elements through the create or change 
element operation easily and efficiently. 


Create 


To define a new element in the list view, do the following. 


Step 1. Press one of the following function keys depending on the type of element 
regardless of the cursor position. 


Text 

Line 

Box 

Bar Code 
Graphics 


F6 

F9 

F10 

F11 

F13 then F6 


Page segment F13 then F9 
Record layout F13 then F11 


The key entry area appears at the lower part of the display. The remainder 
of the create element operation is the same as that in the screen view. 


Step 2. Press the F4 key to specify the other parameters if necessary. 
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Step 3. After completing the parameter specification, press Enter to complete the 
create element operation. The newly created element has a sequence 
number one greater than that of the last element created, and is added to 
the bottom of the list. 


Change 


To change an existing element, do the following. 

Step 1. Place the cursor on the line of the element to be changed. 

Step 2. Press the F14 key. The key entry area appears at the lower part of the 
display. The remainder of the change element operation is the same as the 
create element operation, except that the parameters appear on the key 
entry area with the values previously specified. 

Step 3. Press the F4 key to specify the other parameters if necessary. 


Step 4. After completing the parameter specification, press Enter to complete the 
change element operation. The list reflects the changes of the element. 


Sort Element List 


On the list edit panel, when F4 is pressed with the cursor positioned in the NBR 
field, the NAME field, the ACROSS field, or the DOWN field, the list is sorted 
according to the contents of the field and re-displayed. 


If the measurement method is not the same for all elements in the list, the list 
cannot be sorted by the ACROSS field or DOWN field. 


If the cursor is positioned in the name field, elements which have nothing shown 
in the field will be assigned a name consisting of the one-character ID followed by 
the three-character number displayed in the NBR field. This is the same as the 
element mark displayed in screen edit mode without the asterisk. The name 
assigned will not be displayed. 


Elements added to a sorted list will be added at the bottom of the list. Elements 
which are changed in a sorted list will remain in the same list position until the list 
is sorted again. 


Copy, Move, Remove, or Restore 


In the list view, you can copy, move, or remove the existing elements using the 
element edit function. You can restore removed elements, which is impossible in 
the screen view. 


Element Edit 


To copy, move, remove, or restore an element, do the following: 

Step 1. Place the cursor in the NBR column on the line of the element to be 
copied, moved, removed, or restored on the image area. 

Step 2. Type one of the following commands and press the Enter key. The 
operation to be executed is determined by the option selected. 


Cc Copies the element. 


The key entry area appears at the lower part of the display, and you can 
specify the position in the Across prompt and the Down prompt of the 
new element. 


The newly created element is added after the last line of the list and the 
display scrolls to show the new element. The original element is not 
affected by the copy. 
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Moves the element. 


The key entry area appears at the lower part of the display, and you can 
specify the position in the Across prompt and the Down prompt to 
specify the new position of the element. 

Removes the element. 


The removed mark (*) appears in the ID column. The remove operation 
does not affect the removed element or other remaining elements. In the 
screen view, the removed elements do not appear on the image area, and 
you cannot change them. However, in the list view, they appear in the 
image area with an asterisk in the ID column. Removed elements are not 
printed. 

Restores the element. 


The removed mark ’*’, shown in the ID column, disappears. In the screen 
view, the restored elements appear in the image area and they can be 
changed. 


Step 3. Press Enter. (This step is needed for copy and move operations only.) 


The selected element is copied or moved. 
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Chapter 14. Work with Fonts 


This chapter describes what you can specify for the fonts on the Work with Source 
Overlay Fonts display and on the Work with PFD Definition Fonts display. 


le a 


Work with Source Overlay Fonts 


Type options, press Enter. 
2=Change 5=Display 9=Set initial font 


Font 
Opt Number Text 
*DEFAULT 10 CPI Courier 
10 CPI Courier 
10 CPI Courier 
10 CPI Courier 
10 CPI Courier 
Courier 
10 CPI Courier 
10 CPI Courier 
10 CPI Courier 


ANAaAHPWNPEHE 
— 
f<>) 
te) 
uv 
4 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 
XY a 
a Work with PFD Definition Fonts ) 
Type options, press Enter. 
2=Change 5=Display 9=Set initial font 
Font 
Opt Number Text 
*DEFAULT 10 CPI Courier 
1 10 CPI Courier 
2 10 CPI Courier 
3 10 CPI Courier 
4 10 CPI Courier 
5 10 CPI Courier 
6 10 CPI Courier 
7 10 CPI Courier 
8 10 CPI Courier 
Bottom 
F3=Exit F5=Refresh F12=Cancel 
Xe 


You can specify the source overlay fonts and the PFD definition fonts in the same 
way. Only the display title changes depending on the fonts you work with. 


The examples that follow refer to PFD Definition Fonts, and they also apply to 
Source Overlay Fonts. 


For each element (text, bar codes with HRI, or box containing text) on the Design 
Overlay, Design Record Layout, or Design Page Layout screens that requires a font, 
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the font is specified with a font number or font local identifier (1-8) or *DEFAULT. 
In this display, you can specify which font is actually used for each font local ID. 


Fonts are stored either in the printer (printer-resident) or on the iSeries system 
(host-resident). Printer-resident fonts are selected by using a Font Global ID 
(FGID), while host-resident fonts are selected either by using a coded font name or 
a combination of a code page and character set. The FGID is a number, such as 011 
for Courier or 5687 for Times New Roman. Most printers have an operations panel 
option that will print out all of the printer-resident fonts along with the FGID 
number. 


Host-resident fonts are iSeries objects and are stored in iSeries libraries. For 
example, there is a set of 240 dots per inch (dpi) IBM Compatibility fonts that are 
shipped with iSeries and reside in the QFNTCPL library. With printers supporting 
240 dpi, 300 dpi, and 600 dpi print resolutions, the IBM Compatibility fonts are 
probably insufficient for most applications. The IBM AFP Font Collection (5648-113) 
is a comprehensive set of AFP fonts supporting all of the various printer 
resolutions as well as the most common type styles used in business documents. 
Fonts for 240 dpi and 300 dpi resolutions are raster or bit-mapped fonts. This 
means that each character is comprised of a pattern of dots. Each character set 
contains all of the characters required (these characters can vary because there are 
over 48 different languages supported within the AFP Font Collection). There is a 
different character set for each point size and each typeface to be used. Refer to 

1 for samples of the most commonly used 
font anacer sets. For example, character set COH40060 is a Helvetica Roman Bold 
6-point while COH400Z0 is Helvetica Roman Bold 36-point. 


The IBM AFP Font Collections also contains outline (scalable) fonts. With outline 
fonts, each character is represented by a series of vectors. As a result, one character 
set can be "scaled" to any point size. For example, the outline character set for 
Helvetica Roman Bold is CZH400. This one character set can print characters in 
any point size. With a printer that supports host-resident outline fonts, this font is 
downloaded to the printer and the printer will scale the characters as required. 


The two types of fonts, printer-resident and host-resident, can be specified in three 
different ways within AFP/U: 


¢ Font Global ID (FGID) 
* Coded Font Name 
* Code Page and Character Set Name 


The coded font name is, in essence, the same as a code page and character set 
name. A coded font name is simply a shorthand notation for a code page and 
character set name combination. The code page is a table that facilitates certain 
country and character differences. For example, the code page T1V10037 is a 
standard US English code page while the code page T1V10285 is a standard United 
Kingdom English code page. There are minor differences in the text produced by 
using either of these code pages. 


The following table explains the Work with Source Overlay Fonts display and the 
Work with PFD Definition Fonts display. 
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Table 62. Work with Source Overlay Fonts display fields 


Field Name Description 

2=Change This option allows you to change the definition of a font. Type 2 
(Change) in the Opt column beside the font you want to change. 

5=Display This option allows you to display the definition of a font. 


9=Set initial font 


Opt 


Font number 


Text 


This option allows you to change the definition of a font to the initial 
values. 

Specify the option number next to one or more font numbers to 
perform the options, one after another. 

Shows the font number of each font. 


Font number is always 1 - 8 or *DEFAULT. 
Shows the description of the font. 


Note: An error message is displayed when the font type you select using option 2 
(Change) or option 9 (Set default) causes a conflict. The conflict occurs 
because the selected font type cannot be used with the values specified for 
the printer type or other prompts of some elements. In such cases, by 
pressing the Enter key again, the system changes the values for the prompts 


as follows: 

New Font Printer Type Element Prompt Old Value New Value 

Type (Affected) (You (System 
Specified) Changed) 

1 2 Text, Box Format 253 1 

2 4,5, 6 Text, Box Overstrike Other than Blank 
blank 

2 4,5, 6 Text, Box Underline Y N 

2,0 2. Text Character size Other than *DEFAULT 
*DEFAULT 
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2=Change Font 
To change the font, do the following on the Work with Source Overlay Fonts 
display or the Work with PFD Definition Fonts display. 
1. Type 2 in the Opt column beside the font number you want to change. 
2. Press Enter. 


The following display appears: 


( Change PFD Definition Font >) 


Font inumber 3.4% 4 56.2 J 
Type choice, press Enter. 
FONE LEY DOr teense secteur coe 1 1=Font and character identifier 


2=Coded font 
3=Code page and font character set 


F3=Exit F5=Refresh  F12=Cancel 


Ns o 


Specify 1, 2, or 3 and press Enter. 


The following table explains the Change Source Overlay Font display and the 
Change PFD Definition Font display. 


Table 63. Change Source Overlay Font display fields 


Field Name Description 

Font number Shows the font number of the font being changed. 

Font type Specifies a font type if you want to change the way to specify a font. 
See Fonts” on page 458] for more information about font type. 


The display that appears next is different depending on your choice for the Font 
type prompt. 


Some fonts reside in the printer, while some fonts reside in the system and are 
downloaded to the printer. To use the former fonts, type 1 in the Font type prompt. 
To use the latter fonts, type 2 or 3 . Those fonts that reside in the system consist of 
three objects: 


Coded font 


Has an object type *FNTRSC with attribute CDEFNT. Coded fonts for 
SBCS fonts contain a code pair consisting of a code page name and font 
character set name. Coded fonts for DBCS fonts contain many pairs of 
code page names and font character set names. 
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To use an SBCS font that resides in the system, you can specify either a 
coded font name or a pair of code page name and font character set name. 
To use a DBCS font that resides in the system, you must specify a coded 
font name. 


Code page 
Has an object type *FNTRSC with attribute CDEPAG. A code page has 
many code points and their corresponding character identifiers. Character 
identifiers are mapped to corresponding character patterns by a font 
character set. 


Font character set 
Has an object type *FNTRSC with attribute FNTCHRSET. A font character 
set has many character identifiers and their corresponding character 
patterns. 


The WRKFNTRSC command shows you a list of font resources. Most fonts reside 
in libraries that have names that start with QFNT. 


Change Font (Font Type=1): When you choose 1 for the Font type prompt, the 
following display appears. 
iz > 


Change PFD Definition Font 


Font number avsen ce 1 
BONE SEY PC. soMs eek ce tere ool Font and character identifier 


Type choices, press Enter. 


Font: 
Tdenti flier estes ce ve ees 11 1-65535 
POUNEYSTZO ye 6 se see ep ov tee *NONE 0.1-999.9, *NONE 
Character identifier: 
Graphic character set .. *SYSVAL 1-32767, *SYSVAL 
Code page’ + 2 «sa «us 1-32767 
Text 'description’..... 10 CPI Courier 


F3=Exit F5=Refresh  F12=Cancel 


ss Ld 


Using this display, you can change the font identifier, point size, graphic character 
set, code page, and the description text. 


Table 64. Change PFD Definition Font display fields 


Field Name Description 

Font number Shows the font number of the font being changed. 

Font type Shows the font type you specified in the previous display. 

Identifier Specifies the font identifier. You can specify a number from 1 to 65535 
for your font. 

Point size Specifies the point size. You can use a value from 0.1 to 999.9 for your 
point size. 

Graphic character Specifies the graphic character identifier. You can use a number from 

set 1 to 32767. You can also specify *SYSVAL. 
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Table 64. Change PFD Definition Font display fields (continued) 


Field Name Description 

Code page Specifies the code page. You can type a number from 1 to 32767 for 
your code page. 

Text Specifies the description for this font. This is just a remark and is 


helpful to you when you select a font from the list. 


See the description of the CRTPRTF command in the CL Reference for more 
information about these parameters. 


Change Font (Font Type=2): When you choose 2 for the Font type prompt, the 
following display appears. 


( Change PFD Definition Font > 


FONE MUMDES “eas ast por tctes ee ae as 1 
FONtALYPer yn coats ere cote Ae Coded font 


Type choices, press Enter. 


COGEOICEONE. 0 swe S) ee Name, F4 for list 
PONS ZOs co ceahee curs caren ee *NONE 0.1-999.9, *NONE 


F3=Exit F4=Prompt F5=Refresh  F12=Cancel 
“ 


Using this display you can change the coded font to use, point size for outline 
fonts, and description text. 


The following table explains the Change Source Overlay Font display and the 
Change PFD Definition Font display. 


Table 65. Change Source Overlay Font display fields 


Option Description 

Font number Shows the font number of the font being changed. 

Font type Shows the font type you specified in the previous display. 

Coded font Specifies a coded font name. To display a selection list of all coded 


fonts in library QFNTCPL and all libraries in your library list, press F4 
with the cursor in this field. 

Point size Specifies the point size you want. You can use a value from 0.1 to 
999.9 for the point size. 1 point is equal to 1/72 inch. Point size is only 
valid for outline fonts. The value will be ignored for raster fonts. 
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Table 65. Change Source Overlay Font display fields (continued) 


Option 


Description 


Text 


Specifies the description for this font. This is just a remark and is 


helpful to you when you select a font from the list. 


This field is automatically filled with the description text of the coded 
font if this field is blank when a coded font is selected from the list in 
the display shown by pressing F4. 


Change Font (Font Type=3): When you choose 3 for the Font type prompt, the 
following display appears. 


Pe 


XX 


Change PFD Definition Font >) 
Font: number t.. 20.0 seuss ee 1 
Font. type: 2 saa wa a aod 38 Code page and font character set 
Type choices, press Enter. 
Code page 3. soe: eo ays Name, F4 for list 
Font character set... . « Name, F4 for list 
POWNt S1Z@: ses Wie ee es *NONE 0.1-999.9, *NONE 
Text 'description’..... 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel 
y 


Using this display you can change the code page, font character set, point size for 
outline fonts, and description text. 


The following table explains the Change Source Overlay Font display and the 
Change PFD Definition Font display. 


Field Name 


Description 


Font number 
Font type 
Code page 


Font character set 


Point size 


Shows the font number of the font being changed. 

Shows the font type you specified in the previous display. 
Specifies a code page name. To display a selection list of all code 
pages in library QFNTCPL and all libraries in your library list, press 
F4 with the cursor in this field. 

Specifies a font character set. To display a selection list of all font 
character sets in library QFNTCPL and all libraries in your library 
list, press F4 with the cursor in this field. 

Specifies the point size you want. You can use a value from 0.1 to 
999.9 for the point size. 1 point is equal to 1/72 inch. Point size is 
only valid for outline fonts. The value will be ignored for raster 
fonts. 
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5=Display Font 


Field Name Description 


Text Specifies the description for this code page and font character set. 
This is just a remark and is helpful to you when you select a code 
page or font character set from the list. 


When a code page is selected from the list, this field is 
automatically filled with the description text of the code page if this 
field is blank. 


When a font character set is selected from the list, this field is 
automatically filled with the description text of the font character 
set if this field is blank. 


To display the font, do the following on the Work with Source Overlay Fonts 
display or the Work with PFD Definition Fonts display. 


1. Type 5 in the Opt. column beside the font number you want to display. 
2. Press Enter. 


Display Font (Font Type=1): 


(~ Display PFD Definition Font >) 


Font number: «2 2.9 34 2 a 1 
ROME GtYpe> sits <r se see eo ce | al Font and character identifier 
Font: 
Identifier. © 3 a2 3 11 
Podntesize ws < 2s. 34: a ~~ *NONE 
Character identifier: 
Graphic character set ..:  ¥*SYSVAL 
Code-page: << 3 3 2 aS 
TOXite esa taesy conten coh vol seyeicay ve eetes 10 CPI Courier 


Press Enter to continue. 
F3=Exit F12=Cancel 
<9 ay 


On this display, you can see the definition of a type 1 font in detail. 
Table 66. Display PFD Definition Font display fields 


Field Name Description 

Font number Shows the font number. 

Font type Shows the font type (Font and character identifier) 
Identifier Shows the font identifier. 

Point size Shows the point size. 

Graphic character set Shows the graphic character set. 

Code page Shows the code page number. 

Text Shows the description of the font. 
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Display Font (Font Type=2): 


(~ Display PFD Definition Font > 
FOnenumber= 5 rate cs se hee 1 
ONE GEV POs sso cee esereatearern vers secete 22 Coded font 
Godedetont 2 ay dete wars ce eet XO0GB12 
POIMIESHZO 2s sore Ge eatse ae tet eens *NONE 
(N=) eee te rieety areata ects ree ce BOLD 12 CPI 
Press Enter to continue. 
F3=Exit F12=Cancel 
ne Zp 
This display shows the definition of a type 2 font. 
The following table explains the Display Source Overlay Font display and the 
Display PFD Definition Font display. 
Table 67. Display Source Overlay Font display fields 
Field Name Description 
Font number Shows the font number. 
Font type Shows the font type (Coded font) 
Coded font Shows the coded font name. 
Point size Shows the point size. 
Text Shows the description of the font. 
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Display Font (Font Type=3): 


ie Display PFD Definition Font 
FONE NUMDOR Sree msec teh acts acl 
FONG sty POares ta carsusesuee cons: go Code page and font character set 
Code page ........ +. : &£z41TIDOBASE 
Font character set... .. :  CODODB10 
POIMt Sizes. se. ee et  ANONE 
Text... 2 6s «© ss 3 GOTHIC ROMAN BOLD 10 POINTS 


Press Enter to continue. 


F3=Exit F12=Cancel 


XX 


This display shows the definition of a type 3 font. 


The following table explains the Display Source Overlay Font display and the 
Display PFD Definition Font display. 


Field Name Description 

Font number Shows the font number. 

Font type Shows the font type (Code page and font character set) 
Code page Shows the code page name. 

Font character set Shows the font character set name. 

Point size Shows the point size. 

Text Shows the description of the font. 


9=Set Initial Font 


To change the definition of a font to the initial values, do the following on the 

Work with Source Overlay Fonts display or the Work with PFD Definition Fonts 

display. 

1. Type 9 in the Opt. column beside the font number for which you want to 
change the definition. 


2. Press Enter. 
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Part 5. Resource Management Utility 


Chapter 15. Introduction to Resource Management Utility (RMU) . 
Converting to an iSeries Page Segment . . 
Converting to a Page Segment from an iSeries Database File 

Converting to a Page Segment from a PC Document . 
Working with Overlays . 

Copying an Overlay . 

Deleting an Overlay . 

Renaming an Overlay 

Printing an Overlay . : 

Displaying an Overlay Description : 

Changing an Overlay Description 

Converting an Overlay to Physical File Meniber. 
Working with Page Segments . 

Copying a Page Segment 

Deleting Page Segments . 

Renaming a Page Segment . 

Printing a Page Segment 

Displaying a Page Segment Description 

Changing a Page Segment Description . 

Converting a Page Segment to a Physical File Member 


Chapter 16. Getting Started with the Resource Management ai 
Starting Resource Management Utility . : be. NR 
Converting a PC Document to a Page Segment . 

Printing an Overlay . 

Printing a Page Segment 


Chapter 17. Starting and Ending the Resource Management Utility . 
Starting the Resource Management Utility . 
Starting the Resource Management Utility with fhe STRAFPU Command 
Option 21 : Convert to Page Segment Function . 
Option 22 : Work with Overlays Function . 
Option 23 : Work with Page Segments Function . 
Starting the Resource Management with the CVTPCDPAGS Coamind!. 


Starting the Resource Management Utility with the CVTPFMPAGS Command 
Starting the Resource Management Utility with the CVTOVLPFM Command . 
Starting the Resource Management Utility with the CVTPAGSPFM Command 


Ending the Resource Management Utility . 
Chapter 18. Convert to Page Segment Function. 


Chapter 19. Work with eee Function . 
Prompts . : 

Options 

Columns . 

3=Copy Overlay Object . 

4=Delete Overlays. 

6=Print Overlay 

7=Rename Overlay 

8=Display Overlay Description : 
9=Convert Overlay to Physical File Menibes : 
13=Change Overlay Text Lo 


Chapter 20. Work with Page Segments Function 
Prompts . S Boe eR aa oe ek 


. 309 
. 309 
. 309 
. 310 
. 311 
. 311 
. 311 
. 312 
. 312 
312 
. 312 
. 312 
. 312 
312 
. 312 
. 312 
. 312 
. 313 
. 313 
. 313 


. 315 
. 315 
. 316 
. 318 
. 320 


. 323 
. 323 
. 323 
. 324 
. 324 
. 324 
. 324 
. 326 
. 328 
. 329 
. 330 


. 331 


. 341 
. 342 
. 342 
. 343 
. 343 
. 344 
. 344 
. 346 
. 346 
. 346 
. 349 


. 351 
. 352 
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Options 

Columns . 

3=Copy Page Segment 

4=Delete Page Segments. 

6=Print Page Segment 

7=Rename Page Segment 

8=Display Page Segment Description 


9=Convert Page Segment to Physical File Mémber : 


13=Change Page Segment Text 
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. 353 
. 353 
. 354 
. 354 
« OOD 
. 356 
. 356 
. 357 
. 360 


Chapter 15. Introduction to Resource Management Utility 
(RMU) 


The Resource Management Utility is one of the AFP Utilities that allows you to 
manage the AFP resources, such as overlay objects, that are created by the or page 
segments interactively. 


The Resource Management Utility has the following three functions: 
* Convert to page segment 

* Working with overlays 

* Working with page segments 


Converting to an iSeries Page Segment 


When you want to place images in an overlay or you want to print a page which 
contains some images such as signatures or logos, you need to store these images 
on the server as page segments before you use them with the Overlay Utility or 
the Print Format Utility. 


This function allows you to create a from the following: 


* An iSeries database file that contains an Image Object Content Architecture 
(IOCA) function set 10 image. 


* A PC document that contains an Image Object Content Architecture (IOCA) 


function set 10 image and is stored in a server folder using the iSeries Access 
shared folder function. 


To create a page segment from a file containing an image data stream (IMDS) 
image, use the CRTPAGSEG command. 


Converting to a Page Segment from an iSeries Database File 


When your server is connected to a System/370 through a communication line, 
you can create a page segment from a database file of image data by the following 
steps: 


1. Use a System/370 image application to create an image of an IOCA function set 
10 image. 


Store the image in a System/370 file. 

Send the image data from the System/370 system to the server. 
Receive the image data as a physical file member. 

Start the (STRAFPU command). 

Select Convert to page segment (option 21). 


PaRwD 
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Converting to a Page Segment from a PC Document 


When you create a page segment from a PC document, do the following to create a 
PC document: 


1. 
2: 


3. 
4. 


Use a PC image application program to create an IOCA function set 10 image. 


Store it in the iSeries folder as a PC document using the iSeries Access shared 
folder function. 


Start the (STRAFPU command). 
Select Convert to page segment (option 21). 


The following figure shows the process of converting to page segment. 


|PC Image | 
Application 
Program 


|iSeries Access| 
|for iSerues | 
Shared Folder 


Function PC Operation 
| 
| Lsecseccseetoen 
iSeries 
Database File 
a¢ustupeteass | 
PC File 
in iSeries 
| Folder | AFP Utilities Operation on iSeries 
| | 
| Resource | 
| Management | 
| Utility | 
| iSeries | 


|Page Segment | 


Figure 21. Process of Converting to Page Segment 


The page segment created and stored in the resource library by the Resource 
Management Utility can be used to create the following examples. 
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MEMO ONE 


TD: J.D. SWIFT. 
SALES DEPARTMENT 


|AMIMPRESSED WITH YOUR 

STEADY INCREASE IN SALES. 
Stored Page Segment LET’SGET TOGETHER AND 
DISCUSS SOME STRATEGY. 


d CALL MY SECRETARY FOR 
L 5 ANAPPOINTMENT. 


= Fred Sones 


MEMO TWO 


FROM: oy vat 


To: AllEmployees 


Beginning this Friday 
our work week will end 
at3 p.m. Enjoy this 
extra leisure time. 


Figure 22. Letter which contain a Page Segment 


Working with Overlays 


This function allows you to: 

* Copy an overlay object in a library 

* Delete overlay objects in a library 

* Print an overlay in a library 

* Rename an overlay in a library 

* Display the description of the overlay object 

* Change the description text of the overlay object 
* Convert an overlay to a physical file member 


Copying an Overlay 


This function calls the CL command CRTDUPOBJ and copies an overlay object to 
a new one. 


Deleting an Overlay 
This function calls the CL command DLTOVL and deletes the specified overlay. 
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Renaming an Overlay 
This function calls the CL command RNMOBJ and renames the specified overlay. 


Printing an Overlay 
This function allows you to print an iSeries overlay on an IPDS printer. The 
Resource Management Utility generates the AFPDS data stream as a spooled file 
that is to be printed on an IPDS printer by the iSeries. 


Displaying an Overlay Description 
This function calls the CL command DSPOBJD and displays the overlay 
description. 


Changing an Overlay Description 


This function calls the CL command CHGOBJD and changes the overlay 
description. 


Converting an Overlay to Physical File Member 


This function allows you to convert an overlay to a physical file member. You can 
transfer the overlay to another system such as the System/370. 


Working with Page Segments 


This function allows you to: 


Copy a page segment object in a library 

Delete page segment objects in a library 

Rename a page segment object in a library 

Print a page segment object in a library 

Display the description of the page segment 
Change the description of the page segment 
Convert a page segment to a physical file member 


Copying a Page Segment 
This function calls the CL command CRTDUPOBJ and copies a page segment to a 
new one. 


Deleting Page Segments 


This function calls the CL command DLTPAGSEG and deletes the specified page 
segments. 


Renaming a Page Segment 


This function calls the CL command RNMOBJ and renames the specified page 
segment. 


Printing a Page Segment 
This function allows you to print an iSeries page segment on an IPDS printer. The 
Resource Management Utility generates the AFPDS data stream as a spooled file 
that is to be printed on an IPDS printer by the iSeries. 
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Displaying a Page Segment Description 
This function calls the CL command DSPOBJD, and displays the page segment 
description. 


Changing a Page Segment Description 


This function calls the CL command CHGOBJD, and changes the page segment 
description. 


Converting a Page Segment to a Physical File Member 


This function allows you to convert a page segment to a physical file member. You 
can transfer the page segment to another system such as the System/370. 
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Chapter 16. Getting Started with the Resource Management 
utility 
This chapter describes how to do some typical tasks of the Resource Management 
Utility. 
This chapter includes the following tasks: 
1. Converting a PC document to a page segment 


2. Printing an overlay 


3. Printing a page segment 
You do not need to perform these tasks sequentially because they are independent. 


Note: To perform some of the tasks, you need to prepare input data for the tasks. 
Please read the first part of each section for detail. 


Starting Resource Management Utility 


Example Actions: 
1. Type STRAFPU on the command line. 
2. Press the Enter key. 


The IBM Advanced Function Printing Utilities for iSeries menu appears. 
‘a AFPU *) 


IBM Advanced Function Printing Utilities for iSeries 


Select one of the following: 


Overlay Utility 
1. Work with source overlays 
2. Work with source overlay files 


Print Format Utility 
11. Work with PFD definitions 
12. Work with PFD definition files 
13. Print database file member 
14. Print AFP Utilities tutorial 


Resource Management Utility 
21. Convert to page segment 
22. Work with overlays 
23. Work with page segments 


Selection or command 
Ss==> 2] 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F16=System main menu 
(C) COPYRIGHT IBM CORP. 1991, 1993. 


You can start the following three Resource Management Utility functions from this 


display: 

Selection Function 

21 Convert to Page Segment 
22 Work with Overlays 
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Selection Function 
23 Work with Page Segments 


Converting a PC Document to a Page Segment 


Note: To perform the following task, you need a PC document, in a folder, that 
contains IMDS format or IOCA function set 10 image data. To create a PC 
document, do the following: 


1. If necessary, ask the system administrator to add a directory entry 
(ADDDIRE) for your user ID. 


2. Create a folder using the Create Folder (CRTFLR) command. 


3. Ona personal computer that is connected to the server and has iSeries 
Access shared folder function running on it, create an IMDS format or an 
IOCA function set 10 image data file with an image handling program. 


4. On the personal computer, copy the file to a document in a shared 
folder. 
In the following examples, the following names are used: 
IOCAFLR for the folder name 
LOGO for the PC document name 
MYLIB for the library name 
LOGO for the page segment name 


You may change these names to your own names. 


Example Actions: 
1. Type 21 on the Selection or command line in the display. 
2. Press the Enter key. 


The Convert to Page Segment display appears: 
a > 


Convert to Page Segment 


Type choices, press Enter. 


Page segment. ....... LOGO Name 
Lib rarye tcc wren trees ne MYLIB Name, *CURLIB 
Source object type. .... if 1=PC document, 2=File 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 


\e oe 
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You are required to enter the qualified name of the page segment to be created and 
the object type of the input data. 


Example Actions: 

1. Type LOGO for the Page segment prompt. 
2. Type MYLIB for the Library prompt. 

3. Type 1 for the Source object type prompt. 
4. Press the Enter key. 


Remaining parameters appear according to the specified object type of the input 
data. 


e >) 


Convert to Page Segment 


Type choices, press Enter. 


Page segment. ......2. LOGO Name 
eDraVy corse eee) aie eoeee MYLIB Name, *CURLIB 

Source object type. .... 1 1=PC document, 2=File 

Rrome-tolder™ saci coved sevens IOCAFLR 

From PC document ...... LOGO Name 

Change image size ..... N Y=Yes, N=No 

Degree of rotation. .... 0 0, 90, 180, 270 

AUGHORUEYS gana Covent sale ciate *LIBCRTAUT Name, *LIBCRTAUT, *CHANGE 
*ALL, *USE, *EXCLUDE 

Text 'description’ ..... Logo 

Repilia Ces cia temas: bones centres Y Y=Yes, N=No 


Bottom 


F3=Exit F5=Refresh  F12=Cancel 


Bd 


You are required to enter the folder name and the PC document name. You may 
also enter other parameters; for example, type Y for the Change image size prompt if 
you want to increase or decrease the image size or type 180 for the Degree of 
rotation prompt if you want to print the image upside down. 


Example Actions: 

1. Type IOCAFLR for the From folder prompt. 

2. Type LOGO for the From PC document prompt. 
3. Type Logo for the Text ‘description’ prompt. 

4. Press the Enter key. 


The IBM Advanced Function Printing Utilities for iSeries menu appears with a 
completion message. Page segment LOGO has been created in library MYLIB. 
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Printing an Overlay 
Note: To perform the following task, you need an overlay object. To create an 
gurls sie do hy sks described in [Chapter 5 Wark with Sourcd 


In the following examples, the following names are used: 
*LIBL for the library name 
STATIONE for the overlay name 


You may change these names to your own names. 


Example Actions: 
1. Type 22 on the Selection or command line in the display. 
2. Press the Enter key. 


The Work with Overlays display appears: 


( Work with Overlays 
[ETD rainy eoseas eats oo uve ces oe ce *LIBL Name, *LIBL, *CURLIB 
*ALL, *USRLIBL, *ALLUSR 
Overlay circ pte reec mers *ALL Name, generic*, *ALL 
POSACAONS CO) ei ow cay ew cs Starting character(s) 


Type options, press Enter. 
3=Copy 4=Delete 6=Print 7=Rename 8=Display description 
9=Convert to file 13=Change text 


Opt Overlay Library Text 


(No overlays in library) 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve  F1l=Display names only 
F12=Cancel 


Ss 


The display shows all overlays in the libraries in the library list. The number of 
overlays shown in the list depends on your system. You may choose any options 
or enter a library name for the Library prompt to change the list. 


Note: The Opt prompt must be blank when you change the library name. 
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Example Actions: 
1. Type OVLLIB for the Library prompt. 
2. Press the Enter key. 


The same Work with Overlays display shows another list of overlays. 


(~ Work with Overlays > 


IID aneyn Mecsmen cna OVLLIB Name, *LIBL, *CURLIB 
*ALL, *USRLIBL, *ALLUSR 

OVE ay is cess: eveienss, ee teas *ALL Name, generic*, *ALL 

POSAETION tOn vies. s. es aioe ce Starting character(s) 


Type options, press Enter. 
3=Copy 4=Delete 6=Print 7=Rename 8=Display description 
9=Convert to file 13=Change text 


Opt Overlay Library Text 
6 STATIONE OVLLIB Sample Form number 3 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 
F12=Cancel 


a 


You should see the name STATIONE, the overlay you created before, in the list. If 
you do not see the name, press the Page Down (Roll Up) key until the name 
appears or type the name for the Position to prompt and press the Enter key. The 
list is arranged in ascending sequence by overlay name. 


You can choose any option for the overlays. 


Example Actions: 
1. Type 6 in the Opt column beside the overlay name STATIONE. 
2. Press the Enter key. 


The Print Overlay display appears. 
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Print Overlay 


Overlay «2 ss 6 ee i 4 © STATIONE 
[EVID RGIRYs Peau cese-s sce veces seer ec OVLLIB 


Type choices, press Enter. 


Qutput queue. ....... *JOB Name, *JOB 

IID Rays seenecemethe see tres Name, *LIBL, *CURLIB 
COPMCS vce. es oe Newel ss acs 2 1-255 
Print: deli ty. 27 ts: 2. es se ces *CONTENT *CONTENT, *ABSOLUTE 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 


S 2 


Example Actions: 
1. Type 2 for the Copies prompt. 
2. Press the Enter key. 


The Work with Overlays display appears with a completion message. The overlay 
STATIONE has been printed. Press Enter to return to the IBM Advanced Function 
Printing Utilities for iSeries menu. 


Printing a Page Segment 


Note: To perform the following task, you need a page segment. Page segment 
QFCLOGO should exist in library QGPL. If it does not exist, copy page 
segment QFCPAGS from library QAFP to page segment QFCLOGO in 
library QGPL. 


In the following examples, the following names are used: 
QGPL for the library name 
QFCLOGO for the page segment name 


You may change these names to your own names. 


Example Actions: 
1. Type 23 on the Selection or command line in the display. 
2. Press the Enter key. 
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The Work with Page Segments display appears: 
(a >) 


Work with Page Segments 


IETID aeVe see cere ane cree etn *LIBL Name, *LIBL, *CURLIB 
*ALL, *USRLIBL, *ALLUSR 

Page segment ...... *ALL Name, generic*, *ALL 

Posaitaion’ tot sess) at ce Starting character(s) 


Type options, press Enter. 
3=Copy 4=Delete 6=Print 7=Rename 8=Display description 
9=Convert to file 13=Change text 


Page 
Opt Segment Library Text 
6 QFCLOGO QGPL SAMPLE PAGE SEGMENT - IM1 FORMAT 
QFCLOGO2 QGPL SAMPLE PAGE SEGMENT - IOCA FUNCTION SET 10 FORMAT 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F1l=Display names only 
F12=Cancel 


\ yf 


The display shows all page segments in the libraries in the library list. The number 
of page segments shown in the list depends on your system. You may choose any 
options or enter a library name for the Library prompt to change the list. 


Note: The Opt prompt must be blank when you change the library name. 


You should see page segment QFCLOGO and library QGPL in the list. If you do 
not see the name, press the Page Down (Roll Up) key until the name appears or 
type the name for the Position to prompt and press the Enter key. The list is 
arranged in ascending sequence by page segment name. 


Example Actions: 
1. Type 6 in the Opt column beside page segment name QFCLOGO. 
2. Press the Enter key. 


Chapter 16. Getting Started with the Resource Management utility 321 


The Print Page Segment display appears. 


je 


Print Page segment 


Page Segment ..........: QFCLOGO 
[TIDY er cousarsnyooeses sivas ast cc QGPL 


Type choices, press Enter. 


Qutput queue. ....... *JOB Name, *JOB 

LID Raye scene eel neete) ep os Name, *LIBL, *CURLIB 
Opies; «cf a 2 1-255 
Print fidelity. c. 3) so *CONTENT *CONTENT, *ABSOLUTE 


Bottom 
F3=Exit F5=Refresh F12=Cancel 


SS 


Example Actions: 
1. Type 2 for the Copies prompt. 
2. Press the Enter key. 


The Work with Page Segments display appears with a completion message. 
Page segment QFCLOGO has been printed. 


Press Enter to return to the IBM Advanced Function Printing Utilities for iSeries 
menu. 
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Chapter 17. Starting and Ending the Resource Management 
Utility 


Starting the Resource Management Utility 


You can start the by typing the following commands on the command line and 
pressing Enter. 


STRAFPU 


Starts AFP Utilities for iSeries. You can select any function of the Resource 
Management Utility. 


CVTPCDPAGS 


Allows you to convert a PC document in a shared folder to a page 
segment. 


CVTPFMPAGS 
Allows you to convert a member in a physical to a page segment. 
CVTOVLPFM 


Allows you to convert an overlay to a physical file member. 


CVTPAGSPFM 
Allows you to convert a page segment to a physical file member. 


Starting the Resource Management Utility with the STRAFPU 
Command 


When you start the Resource Management Utility with the STRAFPU command, 
the following display appears: 


(neu IBM Advanced Function Printing Utilities for iSeries 
Select one of the following: 


Overlay Utility 
1. Work with source overlays 
2. Work with source overlay files 


Print Format Utility 

11. Work with PFD definitions 

12. Work with PFD definition files 
13. Print database file member 

14. Print AFP Utilities tutorial 


Resource Management Utility 
21. Convert to page segment 
22. Work with overlays 

23. Work with page segments 
Selection or command 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel Fl6=System main menu 


(C) COPYRIGHT IBM CORP. 1991, 1993. 
NS 
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You can start the following three Resource Management Utility functions from this 


display. 

Selection Function 

21 Convert to Page Segment 
22: Work with Overlays 

23 Work with Page Segments 


The following describes the selections available on the above screen. To select one 
of the following, type the number of the selection on the command line, and press 
Enter. 


Option 21 : Convert to Page Segment Function 
The convert to page segment function allows you to create a page segment as 
follows: 


* Specify the name of the page segment to be created and the name of the library 
in which to create the page segment. 

* Specify which kind of input source object you want to convert to a page 
segment. 

* Specify the names of an iSeries folder and PC document when you create a page 
segment from a PC document. 

* Specify the names of an iSeries file member, file, and library when you create a 
page segment from a database file member. 


See hapte a a for more 
information. 


Option 22 : Work with Overlays Function 

The work with overlays function allows you to copy, delete, rename, and print an 
overlay object, display and change the description of an overlay object, and convert 
an overlay object to a physical file member. 


for more information. 


Option 23 : Work with Page Segments Function 

The work with page segments function allows you to copy, delete, rename, and 
print a page segment, display and change the description of a page segment, and 
convert a page segment to a physical file member. 


See (‘Chapter 20. i q i c 1| for more 
information. 


Starting the Resource Management with the CVTPCDPAGS 
Command 


When you start the with the CVTPCDPAGS command, the following display 
appears: 
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Type choices, press Enter. 


NAME, *PRV 


F13=How to use this display 


\ 


Page SCqent 2 ay & « vy ww & « 


IIDMaRY teeta eeroncmeneta sere 
Om hOlders Cars s see cen cee tore ccc 


F3=Exit F4=Prompt F5=Refresh 


Convert PCD to Page Segment (CVTPCDPAGS) 


*CURLIB NAME, *CURLIB 
*PRV 
*PRV NAME, *PRV, *PAGSEG 


Bottom 
F10=Additional parameters  F12=Cancel 


F24=More keys 


7 


The following display appears when you type data in the fields and press the F10 


key. 
rc _ 
Convert PCD to Page Segment (CVTPCDPAGS) 
Type choices, press Enter. 
Page-Se@gment: 6) teas: cen teo a oss es LOGO NAME, *PRV 
[sibwarys Pos sasswesay cess sats eure *CURLIB NAME, *CURLIB 
VOM Older Reese, oie es wee sts LOGOFLD 
Erom PG: doclment: =. % a <. S42 3 cs LOGODOC NAME, *PRV, *PAGSEG 
Change image size ....... *NO *SAME, «NO, *YES 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
wa sy 


Press the Enter key and the following display appears. 
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Convert PCD to Page Segment (CVTPCDPAGS) 


Type choices, press Enter. 


Page: Segment. 2, ai iec 3) Sy cece es > LOGO NAME, *PRV 

IID AR Vie tee cease ten kelicoeecdte Sours *CURLIB NAME, *CURLIB 
Eromo holden? aes nveecsce sy teas ce > LOGOFLD 
From PC document «ss. % < «© « > LOGODOC NAME, *PRV, *PAGSEG 
Change image size ....... *NO *SAME, *NO, *YES 
Degree of rotation. ...... * SAME 0, 90, 180, 270, *SAME 


Authority: co) sok @ Ges, eee * SAME NAME, *LIBCRTAUT, *CHANGE... 
Text “description” <3 % <6 a < * SAME 
Replace 2 ge a Sl A oe we *YES *NO, *YES 

Bottom 


F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Ne 


From this display, you can convert a PC document in a shared folder to a page 
segment. 


A on 


See e 
bage 374 for more information. 


Starting the Resource Management Utility with the 
CVTPFMPAGS Command 


When you start the Resource Management Utility with the CVTPFMPAGS 
command and press the F4 key, the following display appears: 


(~ Convert PFM to Page Segment (CVTPFMPAGS) 
Type choices, press Enter. 
Page Segment: sa <= «+ % & we 6 
NAME, *PRV 

WabRarys ee Se Si XS ee oe *CURLIB NAME, *CURLIB 
EY OM tole svar ues eer pee isola *PRV NAME, *PRV 

[iDRarya ene een sore ae eureuce NAME, *LIBL, *CURLIB 
Eromumember és a0 3) we ae Bh *PRV NAME, *PRV, *PAGSEG 

Bottom 

F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 
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The following display appears when you type data in the fields and press the F10 


key. 
ie Convert PFM to Page Segment (CVTPFMPAGS) = 
Type choices, press Enter. 
Page segment... 2... sees LOGO NAME, *PRV 
Libraieys As oe, ee: eae es een ee *CURLIB NAME, *CURLIB 
LAR OISIEIOLT Nemcratte nce Pe acrietercra gen Pern LOGOFILE NAME, *PRV 
[sliDRaY = en aceteateeeet eerste secs *CURLIB NAME, *LIBL, *CURLIB 
From-member is. -se ce; x. “ce: es a LOGOMBR NAME, *PRV, *PAGSEG 
Change image size ....... *NO *SAME, *NO, *YES 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
XY / 
Press the Enter key and the following display appears. 
a Convert PFM to Page Segment (CVTPFMPAGS) +) 
Type choices, press Enter. 
PRag@“S@GMenitsrnreces emcee a vureaaee > LOGO NAME, *PRV 
LESiLy etcheaye merece cy Se arratrne ra ane rer har *CURLIB NAME, *CURLIB 
FROMmiiie: Gs ptracetrarcecct series eters > LOGOFILE NAME, *PRV 
Eiibrairy). 28. secs; en eee ee >  *CURLIB NAME, *LIBL, *CURLIB 
Eromemember sg) fesaess 4: ie. verpeae > LOGOMBR NAME, *PRV, *PAGSEG 
Change image size ....... *NO *SAME, «NO, *YES 
Degree of ‘rotation: 36.40 3 5 * SAME 0, 90, 180, 270, *SAME 
Additional Parameters 
Authoviitys .:.cc, ase Geesd cs sane * SAME NAME, *LIBCRTAUT, *CHANGE... 
TEXt AGES CrIPETOM oes io: ce cones oe * SAME 
Replace: 2:45 Sos wie we SO *YES *NO, *YES 
Bottom 
F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display 
F24=More keys 
Xe ey 


From this display, you can convert a member in a database file to a page segment. 


See 
ln page 378 
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Starting the Resource Management Utility with the 
CVTOVLPFM Command 


When you start the Resource Management Utility with the CVTOVLPFM 
command and press the F4 key, the following display appears: 


(" Convert Overlay to PFM (CVTOVLPFM) 
Type choices, press Enter. 
Overlays 4. x: i ae Rp i ee 
NAME 
library cee cer seestctersonso ears *LIBL NAME, *LIBL, *CURLIB 
Format. of data... . 4% 42 = 
*FIXED, *CONTINUOUS 
Osta Gear emcctrsets eee ccs sateen st. Nemes 
NAME, *VM, *MVS 
[EID Rays as cr cts teenee) fut cane *CURLIB NAME, *CURLIB 
TOMNEMDEY 2 5% Sosa Gee we Gos *OVL NAME, *OVL 
Text: ‘description’ 295 4.4. . 2 *OVLTXT 
RepiidGer cas tecuec cures err erat *NO *YES, *NO 
Create stiles oa. tc Saree gsitet ase nse te *NO *YES, *NO 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
S 


From this display, you can convert an overlay object to a database file member. 


When you type data in the fields, change the Create file field to ’*YES’, and press 
the Enter key, the following display appears. 


ie Convert Overlay to PFM (CVTOVLPFM) 


Type choices, press Enter. 


Overihayas 25250 fate seers ete sens > SMPOVL NAME 

IIDRARY Ss etcswes Seehemcsn sehen deus >  QGPL NAME, *LIBL, *CURLIB 
Formateot sdata tse. ccs) ae st oe > *FIXED *FIXED, *CONTINUOUS 
TOetiiee geo eetes sar ccarssteere psa nees > *V/M NAME, *VM, *MVS 

[ID RAN Yi oe tessce ee eass vote oue es *CURLIB NAME, *CURLIB 
TOMMEMDON? weve. ete eee ei usted ae see *OVL NAME, *OVL 
Text “description” 3... < % *OVLTXT 
Replace: 2.0 Sa ae a Se oe *NO *YES, *NO 
Create Tiles sss ss es) sh eusoes os > *YES *YES, *NO 
Text, 'deseriptton’= -. 2.2 6 es *BLANK 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


See O 
bage 384 for mo 


328 AFP Utilities for iSeries: User’s Guide 


Starting the Resource Management Utility with the 
CVTPAGSPFM Command 


When you start the Resource Management Utility with the CVTPAGSPFM 
command and press the F4 key, the following display appears: 


( Convert Page Segment to PFM (CVTPAGSPFM) ) 


Type choices, press Enter. 


Page S@gMent «a « % « « % 8 « « 
NAME 
[IDG ee ee reer, Scores creer *LIBL NAME, *LIBL, *CURLIB 
FOnma tot datas x: ce: se. tc ot ss, weer 


TOs fieli@umrcmervemete mecee ere were ss 
NAME, *VM, *MVS 
[ibwarys se eae cow ste cyeueeoee *CURLIB NAME, *CURLIB 
TOMMEMDER = yret accesses faye beac es *PAGSEG NAME, *PAGSEG 
Text “description serie -& ices es *PSGTXT 
Repiliacerirns in cer ramse srs coms *NO *YES, *NO 
Create: Tile: se aos wee sls *NO *YES, *NO 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 


F24=More keys 
Ne ea 


From this display, you can convert a page segment to a database file member. 


When you type data in the fields, change the Create file field to ’*YES’, and press 
the Enter key, the following display appears. 


a Convert Page Segment to PFM (CVTPAGSPFM) > 


Type choices, press Enter. 


Page Segment. 3 06: wn os ss fete > QFCLOGO NAME 
[siDVaey cee cere ee cieen tet eee >  QGPL NAME, *LIBL, *CURLIB 
Fonmatsofvidatacs s0hocs siete aus > «FIXED *FIXED, *CONTINUOUS 
Oe tleliCuecye meee ce: seve ee gery Meee > */M NAME, *VM, *MVS 
[sieve Varese ame mieoecn tee ees *CURLIB NAME, *CURLIB 
TOMMEMDER 1 os ek aee se awed ces tee *PAGSEG NAME, *PAGSEG 
Text. “description” «.< .- «. 3 -s *PSGTXT 
RepiltaGes ze <3 ose re ences a> Save ee *NO *YES, *NO 
Create Tie 6x cx tea ce wa es > *VES *YES, *NO 
Texte SdeSCripetOn: es ses eae *BLANK 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


See A M (Conve age 
bn page 387 for more information. 
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Ending the Resource Management Utility 


You can end the Resource Management Utility by pressing the F3 key on the 
Convert to Page Segment display, the Work with Overlays display, or the Work 
with Page Segments display. The display from which you started the Resource 
Management Utility will appear. 
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Chapter 18. Convert to Page Segment Function 


To start the convert to page segment function, type 21 on the Selection or 
command line on the IBM Advanced Function Printing Utilities for iSeries menu 
and press Enter. The Convert to Page Segment display appears: 


(— Bi 


Convert to Page Segment 


Type choices, press Enter. 


Page segment .....+.542-. Name 
IIDRAGYO Mterse covet cane comes *CURLIB Name, *CURLIB 
Source object type. .... 1=PC document, 2=File 


Bottom 
F3=Exit F5=Refresh F12=Cancel 


Note: AFP Utilities for iSeries stores the information for Page segment and Library 
in an Interactive Profile Entry for the user profile. These values replace the 
values displayed the next time the function is used. 


The Convert to Page Segment display allows you to create a page segment from 
either a PC document in an iSeries folder or a physical file member. The PC 
document or physical file member must contain image data stream (IMDS) or 
IOCA function set 10 data. The created page segment can be placed in a source 
overlay by using the Overlay Utility, and printed on an IPDS printer. It is also 
possible to place the page segment in a record layout or page layout by using the 
Print Format Utility and print it on an IPDS printer. 


On this display, you need to specify the name of the page segment, library, and 


whether the page segment is to be created from a physical file member or a PC 
document. 
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The following table describes the fields on the Convert to Page Segment display: 
Table 68. Convert to Page Segment display fields 


Field Name Description 
Page segment Specifies the name of the page segment which is being created. 
Library Specifies the name of the library in which the page segment will be 
created. The possible library values in this prompt are: 
*CURLIB 


The current library for the job is used to create the page 
segment. If no library is specified as the current library for 
the job, library QGPL is used. 


Name _ The specified library is used to create the page segment. 
Source object type Specify one of the following to specify from which type of source 
object you are creating a page segment: 


1 To create a page segment from a PC document in an iSeries 
folder. 
2 To create a page segment from a physical file member. 


Type your choices and press Enter. One of the following displays appears 
depending on your selection for the Source object type prompt. 


When you type the page segment name and library and select 1 (PC document) for 
the Source object type prompt, the following display appears. 


fe >) 


Convert to Page Segment 


Type choices, press Enter. 


Page segment .....+5 6-6 LOGO Name 
IIDIRAVVs Ge a Seo ce eee ses Bs MYLIB Name, *CURLIB 
Source object type..... 1 1=PC document, 2=File 


From folder <)lseis. ss.) ve ve 


From PC document ...... Name 

Change image size ..... N Y=Yes, N=No 

Degree of rotation. .... 0 0, 90, 180, 270 
Authority  .. 3. 4s ce 8 oe *LIBCRTAUT Name, *LIBCRTAUT, *CHANGE 


*ALL, *USE, *EXCLUDE 
Text 'description’'..... 


RepiliaGen ve estes ey et ts Y Y=Yes, N=No 


Bottom 
F3=Exit F5=Refresh F12=Cancel 


S od 


When you type the page segment name and library and select 2 (File) for the 
Source object type prompt, the following display appears. 
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4 Convert to Page Segment +) 
Type choices, press Enter. 
Page segment. ......2. LOGO ame 
ETI aY” Sep eee ee, seine er wy eee MYLIB ame, *CURLIB 
Source object type. .... zZ 1=PC document, 2=File 
EVOMmi filer. ceeecoratee sce ame 
LETIDIANY ston ek wet Gee ww es *CURLIB ame, *LIBL, *CURLIB 
From member ........ ame 
Change image size ..... N Y=Yes, N=No 
Degree of rotation. .... 0 0, 90, 180, 270 
AUENORTEYS 5 Genta cdcses: veuuen oe *LIBCRTAUT ame, *LIBCRTAUT, *CHANGE 
*ALL, *USE, *EXCLUDE 
Text 'description’ ..... 
Repilia Coss tn fecratnca cen core-eaeucnune Y Y=Yes, N=No 
Bottom 
F3=Exit F5=Refresh F12=Cancel 
i ay 
The following table describes the fields on the Convert to Page Segment display: 
Field Name Description 
Page segment Specifies the name of the page segment to be created. 
Library Specifies the name of the library in which the page segment will be 
created. The possible library values in this prompt are: 
*CURLIB 
The current library for the job is used to create the page 
segment. If no library is specified as the current library for 
the job, library QGPL is used. 
Name _ Specify the library in which the page segment will be 
created. 
Source object type Specify one of the following to specify from which type of source 
object you are creating a page segment: 
i To create a page segment from a PC document in an iSeries 
folder. 
2 To create a page segment from a physical file member. 


From folder 
From PC document 
From file 


Library 
From member 


Specify the name of the folder that contains the PC document from 
which you want to create a page segment. 

Specify the name of the PC document from which you want to create 
a page segment. 

Specify the name of the file that contains the member from which you 
want to create a page segment. 

Specify the name of the library that contains the file. 

Specify the name of the physical file member from which you want to 
create a page segment. 
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Field Name 


Description 


Change image size 


Degree of rotation 


Authority 


The Resource Management Utility determines the output image size 
that is the same as the input image size. If either the image width or 
length value in the input image size is zero, the Resource 
Management Utility does not create the page segment, and issues an 
error message. 


You can change the output image size. Select one of the following: 


Y (Yes) You will change the output image size. When you select this 
value, the parameter prompts to specify the image size 
appearance. 


N (No) The output image size is the same as the input image size. 
Specify the degree of clockwise rotation of the output image area. You 
can specify 0, 90, 180, and 270 for this parameter. 

Specifies the authority given to users who do not have specific 
authority to the page segment, who are not on the authorization list, 
and whose user group has no specific authority to the page segment. 


You can specify the following values for this parameter: 


*LIBCRTAUT 
The system determines the authority for the page segment 
by using the value specified for the Create authority prompt 
(CRTAUT parameter) on the Create Library command 
(CRTLIB) for the library containing the page segment to be 
created. If the value specified on the Create authority prompt 
(CRTAUT parameter) is changed, the new value will not 
affect this page segment. 


*CHANGE 
Change authority allows the user to perform all operations 
on the page segment except those limited to the owner or 
controlled by object existence authority and object 
management authority. The user can change the page 
segment and perform basic functions on the page segment. 
Change authority provides object operational authority and 
all data authority. 


*ALL All authority allows the user to perform all operations on the 
page segment except those limited to the owner or controlled 
by authorization list management authority. The user 
controls the existence of the page segment, specifies the 
security for the page segment, changes the page segment, 
and performs basic functions on the page segment. The user 
cannot transfer ownership of the page segment. 


*USE Use authority allows the user to perform basic operations on 
the page segment, such as read a page segment. The user is 
prevented from changing the page segment. Use authority 
provides object operational authority, read authority, and 
execute authority. 


*EXCLUDE 
Exclude authority prevents the user from accessing the page 
segment. 


Authorization-list-name 
Specify the name of the authorization list that is used to 
secure the page segment object to be created. 
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Field Name 


Description 


Text ‘description’ Specify the description text that briefly describes the page segment. 
The description text should be specified with no more than 50 
characters of text and enclosed in apostrophes. 

Replace Specifies whether or not the existing page segment is to be replaced, 
when a page segment of the same name already exists in the library. 
You can specify one of the following values: 


Y (Yes) Replace the existing page segment. 


N (No) Do not replace the existing page segment. 


When you select ¥ (Yes) for the Change image size prompt and press Enter, the 
Convert to Page Segment display changes as follows: 


‘a Convert to Page Segment i) 
Type choices, press Enter. 
Page Segment 2. 6 «4 6 « s Name 
Eibia Va Meer cs mewheoccanst st ce Name, *CURLIB 
Source object type. .... 1=PC document, 2=File 
Fromefolder 3 =. #: a wes 
From PC document ...... Name 
Change image size ..... Y=Yes, N=No 
For choice Y=Yes: 
Unit ‘of measure «. . 5 6 s 1=Inch, 2=Centimeter 
Wildl “2 -ves setae sees trdeecoe @.10-22.75 (Inch) 
0.10-57.79 (Centimeter) 
Mengthiess 5%, wie a, oe @.10-22.75 (Inch) 
0@.10-57.79 (Centimeter) 
More... 
F3=Exit F5=Refresh  F12=Cancel 
Ne y 
‘a Convert to Page Segment > 
Type choices, press Enter. 
Mapping option. ..... 1=Position and trim 
2=Scale to fit 
3=Center and trim 
4=Image point to pel 
5=Image point to pel with 
double dot 
Degree of rotation. .... 0, 90, 180, 270 
AUtNOVICyaircoesec escort rye es comes Name, *LIBCRTAUT, *CHANGE 
*ALL, *USE, *EXCLUDE 
Text 'description’'..... 
RepiliaGenees ceases ltausancr ces. fs Y=Yes, N=No 
Bottom 
F3=Exit F5=Refresh  F12=Cancel 
NS ae 
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The following table describes the fields newly shown on the Convert to Page 
Segment display: 


Field Name Description 


Unit of measure This prompt is displayed only when a Y (Yes) is specified in the Change 
image size prompt. It specifies whether inch or centimeter is used as the 
unit of measure for the Width and the Length prompts. 


Select one of the following: 


1 Inch is used for the unit of measure. 
2 Centimeter is used for the unit of measure. 
Width This prompt is displayed only when a Y (Yes) is specified in the Change 


image size prompt. It specifies the horizontal size of output image area 
to be printed. 


The following values can be specified for this parameter: 
* 0.10 - 22.75 (in inches) 


* 0.10 - 57.79 (in centimeters) 

Length This prompt is displayed only when a Y (Yes) is specified in the Change 
image size parameter. It specifies the vertical size of the image area that 
is to be printed. 


The following values can be specified for this prompt: 
0.10 - 22.75 (in inches) 


0.10 - 57.79 (in centimeters) 
Mapping option This prompt is displayed only when a Y (Yes) is specified in the Change 
image size prompt. It specifies how the image is mapped to the output 
image area. 


You can specify one of the following values in this prompt: 


1 (Position and trim) 
The top left corner of the image is specified with the origin of 
the output image area. Any portion of the image that falls 
outside the limits of the output image area is trimmed. 


2 (Scale-to-fit) 
The center of the image is set in the same position as the 
center of the output image area, and the image presentation 
space is scaled to fit within the limits of the output image area. 


3 (Center-and-trim) 
The center of the image is set in the same position as the 
center of the output image area. Any portion of the image that 
falls outside the limits of the output image area is trimmed. 


4 (Image point-to-pel) 
The origin of the image is mapped to the origin of the output 
image area. Any portion of the image that goes outside the 
output image area is truncated at the block boundaries, and no 
resolution correction is done. 


5 (Image point-to-pel with double dot) 
The origin of the image is mapped to the origin of the output 
image area, and each image point is then doubled (replicated) 
in both dimensions. Any part of the image that goes outside 
the output image area is truncated at the block boundaries, 
and no resolution correction is done. 


See the following page for more information. 
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The following figures explain the meaning of the mapping option and the image 


orientation parameters. 


Image data 


Logical page 


Center-and-trim 
mapping 


Mapped Image 


Figure 23. Example of Position-and-Trim Mapping 


Logical page 


Rotated image 


Position of image 


Rotation ~~ 
(degree:90°) ~~~ _ 


Original 
image 


Figure 24. Example of Scale-to-Fit Mapping 
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Some Some Some So me 

Lines of Text Lines of Text Lines of Text Lines of Text 
in a Box in a Box in a Box in aBox 
LEFT TOP CENTER TOP RIGHT TOP BALANCE TOP 
Some Some Some Soo mie 

Lines of Text Lines of Text Lines of Text Lines of Text 
in a Box in a Box in a Box in aBox 


LEFT CENTER 


CENTER CENTER 


RIGHT CENTER 


BALANCE CENTER 


Some 
Lines of Text 
in a Box 


Some 
Lines of Text 
in a Box 


Some 
Lines of Text 
in a Box 


So me 
Lines of Text 
in a Box 


LEFT BOTTOM 


CENTER BOTTOM 


RIGHT BOTTOM 


Figure 25. Example of Center-and-Trim Mapping 
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Figure 26. Example of Rotating the Image Block 
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Chapter 19. Work with Overlays Function 


The work with overlays function allows you to copy, delete, rename, and print an 
overlay object which is built by the overlay utility, display and change the 
description of an overlay, and convert an overlay object to a physical file from the 
list of overlays found in the selected libraries. 


To use a work with overlays function, type 22 on the Selection or command line on 


the IBM Advanced Function Print Utilities for iSeries menu on page and press 
Enter. The following display appears: 
(~ Work with Overlays > 
IETID A Vatceeemcs te eoees esac OVLLIB Name, *LIBL, *CURLIB 
*ALL, *USRLIBL, *ALLUSR 
Overlay <2 2 4% & & 4s *ALL Name, generic*, *ALL 
Position to «4. & 4. se Starting character(s) 


Type options, press Enter. 
3=Copy 4=Delete 6=Print 7=Rename 8=Display description 
9=Convert to file 13=Change text 


Opt Overlay Library Text 
STATIONE  OVLLIB Sample Form number 3 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve  F1l=Display names only 
F12=Cancel 


Ns Ed 


The Work with Overlays display shows a list of overlays in the libraries that you 
specified. If you specified an overlay name or generic name for the Overlay 
prompt, only those overlays that match the specified values are included in the list. 


The following tables describe the Work with Overlays display. 
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Prompts 


Table 69. Work with Overlays Function prompts 
Prompt Description 


Library Specifies the name of the library that contains the overlays to be listed. The 
possible library values in this prompt are: 


*LIBL The library list is used to list the overlays. All overlays that reside in 
all libraries in the library list are included in the list. 


*USRLIBL 
The user portion of the library list is used to create a list of the 
overlays. 


*CURLIB 
The current library for the job is used to list the overlays. If no 
library is specified as the current library for the job, library QGPL is 
used. 


*ALL All libraries in the system are used to create a list of the overlays. 


*ALLUSR 
All user libraries in the system are used to create a list of the 
overlays. All user libraries mean all libraries whose names do not 
start with Q in addition to library QGPL. 


Name __ The specified library is used to create a list of the overlays. 
Overlay Specifies the name of the overlay to be listed. You can use this parameter to 
work with all overlays or a subset of overlays in the specified library. 


*ALL Specify *ALL for a list of all the overlays in the specified library. 


generic* 
Specify a partial overlay name qualified by an asterisk (*) to display 
a list of overlay names that start with the generic name. 


Name _ Specify the name of the overlay which you want to display in the 
list. 
Position to This prompt is used for quick repositioning of the list, not for creating a 
subset of the list. Choose one of the following: 
*TOP Specify *TOP to go to the top of the list. 
*BOT Specify *BOT to go to the bottom of the list. 


name or partial name 
Specify the name or a partial name to go to in the list. The list is 
positioned to the first name beginning with the string specified. 


Options 
Table 70. Work with Overlays Function options 
Option Description 
3=Copy Using this option, you can copy an overlay object using the Create Duplicate 


Object (CRTDUPOBJ) command. 


Specify 3 (Copy) in the Opt column beside the overlay you want to copy and 
press Enter. 


The library in which the overlay is being created must exist. If it does not, 
use the Create Library (CRTLIB) command to create the library before you 
copy an overlay. 
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Table 70. Work with Overlays Function options (continued) 


Option Description 

4=Delete Using this option, AFP Utilities delete an overlay object using the Delete 
Overlay (DLTOVL) command. 
Specify 4 (Delete) in the Opt column beside the overlay you want to delete 
and press Enter. 

6=Print Using this option, you can print an overlay object. 
Specify 6 (Print) in the Opt column beside the overlay you want to print and 
press Enter. 

7=Rename Using this option, you can rename an overlay object. 
Specify 7 (Rename) in the Opt column beside the overlay you want to 
rename and press Enter. 

8=Display Using this option, you can display the description of an overlay using the 

description Display Object Description (DSPOBJD) command. 


9=Convert to 
file 


13=Change 
description 


Specify 8 (Display description) in the Opt column beside the overlay for 
which you want to display the description and press Enter. 
Using this option, you can convert an overlay to a physical file member. 


Specify 9 (Convert to file) in the Opt column beside the overlay which you 
want to convert to a physical file member and press Enter. 

Using this option, you can change the description of an overlay using the 
Change Object Description (CHGOBJD) command. 


Specify 13 (Change description) in the Opt column beside the overlay for 
which you want to change the description and press Enter. 


Columns 


Table 71. Work with Overlays Function columns 


Column Description 

Opt Specify the number of the option beside the overlay that you want to 
work with. 

Overlay Shows the names of the overlays in the library(s) that you specified. 

Library Shows the name(s) of the library(s) in which the overlays reside. 

Text Shows the text that describes the overlays. 


3=Copy Overlay Object 
To copy an overlay object, do the following on the Work with Overlays display on 


page 


1. Type 3 in the Opt column beside the overlay that you want to copy. 


2. Press Enter. 


Then the CL command CRTDUPOB]J will be called. 
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4=Delete Overlays 


To delete an overlay object, do the following on the Work with Overlays display on 
page B4il 

1. Type 4 in the Opt column beside the overlay that you want to delete. 

2. Press Enter. 


The Confirm Delete of Overlays display appears: 
e > 


Confirm Delete of Overlays 


Press enter to confirm your choices for 4=Delete. 
Press Fl2 to return to change your choices. 


Opt Overlay Library Text 
4  STATIONE OVLLIB Sample Form number 3 


Bottom 
Fll=Display names only F12=Cancel 


Ns oy 


On this display, the overlays that you specified to be deleted on the previous 
display are listed. 


Confirm the list and press Enter to delete them or press F12 to cancel. When you 
press Enter, the CL Command DLTOVL is called. 


The following table describes the Confirm Delete of Overlays display. 
Table 72. Confirm Delete of Overlays display fields 


Field Name Description 

Opt The Opt column shows the delete option. A confirmation display is 
shown. For this display, the number 4 is always shown. 

Overlay The overlays which you specified to be deleted on the previous display 
are listed. 

Library The libraries that contain the overlays which you specified to be deleted 
on the previous display are listed. 

Text The text that describes the overlay which you specified to be deleted on 


the previous display is shown. 


6=Print Overlay 


To print_an overlay object, do the following on the Work with Overlays display on 
page bail 

1. Type 6 in the Opt column beside the overlay that you want to print. 

2. Press Enter. 
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The Print Overlay display appears: 


(~ Print Overlay > 
Overlays wa cate caste te OS EATTONE 
Library Ret alaw an vive tes OVLLIB 
Type choices, press Enter. 
Output queue: 2 25 2 sks *JOB Name, *JOB 
DRA Vem coral cametnasicereans Name, *LIBL, *CURLIB 
COPTeS ts os aes, BES ee es 1 1-255 
Print fidelity s:s.56 <e ss *CONTENT *CONTENT, *ABSOLUTE 
Bottom 
F3=Exit F5=Refresh F12=Cancel 
XX ey 


The print overlay function allows you to print an overlay on an IPDS printer. 


From this display, you can specify the name of an output queue, the number of 
copies, and print fidelity. 


The following table describes the Print Overlay display. 


Table 73. Print Overlay display fields 


Field Name Description 
Overlay Shows the name of the overlay to be printed. 
Library Shows the name of the library in which the overlay resides. 


Output queue 


Library 


Copies 


Specifies the name of the output queue in which the spooled file will 
be created. 


The possible values are: 


*JOB Specifies the output queue specified in the job description 
associated with this job is used. 


This is the default value. 


output-queue-name 

Specify the name of the output queue to be used. 
Specifies the name of the library to locate the output queue. The 
possible predefined values are: 


*LIBL The library list is used to locate the output queue. 


*CURLIB 
The current library for the job is used to locate the output 
queue. If no library is specified as the current library for the 
job, library QGPL is used. 


library-name 

Specify the library where the output queue resides. 
Specify the number of copies you want to print. The range of valid 
values is 1 to 255. 
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Table 73. Print Overlay display fields (continued) 
Field Name Description 


Print fidelity Specify the degree of exactness required when printing the overlay. 
The possible predefined values are: 


*CONTENT 
Prints the overlay using all available exception handling. 


*ABSOLUTE 
The job is printed only if the overlay can be printed exactly 
as specified by the data stream and external controls. 


7=Rename Overlay 


To rename an overlay, do the following on the Work with Overlays display on 
page Bail 

1. Type 7 in the Opt column beside the overlay which you want to rename. 
2. Press Enter. 


The CL command RNMOBJ is called. 


8=Display Overlay Description 
To display an overlay description, do the following on the Work with Overlays 
display on page 
1. Type 8 in the Opt column beside the overlay for which you want to display the 
description. 
2. Press Enter. 


The CL command DSPOBUD is called. 


9=Convert Overlay to Physical File Member 


To convert an overlay to a physical file member, do the following on the Work 
with Overlays display on page 


Note: Before you use an overlay in the target system, you have to verify that the 
necessary resources to use that overlay (for example, font and page segment) 
are on the target system. Only transferring an overlay may be insufficient. 
You also have to check the version and the supported structured fields of 
the target system’s Print Services Facility*. 


An overlay which can be used on the iSeries system cannot necessarily be 
used on the target system. 


1. Type 9 in the Opt column beside the name of the overlay which you want to 
convert to a physical file member. 


2. Press Enter. 


The following display appears: 
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Convert Overlay to PFM 


Overlay s&s Be ee > SMPLOVL 
[S| Died gees cee rueeow meets : QGPL 


Type choices, press Enter. 


Format of data. « « « «4 « 1=Fixed, 2=Continuous 


MO tes.) Sekeriea ie Ge cs Name, *VM, *MVS 
LSND IRONY oe om ecu stated sour lyst os *CURLIB Name, *CURLIB 

Jo member 2 . sw « s «6 a = *OVL Name, *OVL 

Text 'description’..... *OVLTXT 

Repilia Cem remredesacou cor entssucaure N Y=Yes, N=No 

Create sTiMe oo tats ee sos neees N Y=Yes, N=No 


F3=Exit F5=Refresh F12=Cancel 


XX 


1. Type data in the prompts. 
2. Press Enter. 


The Text ‘description’ prompt appears as follows when you specify ’Y ’ in the Create 


file prompt: 
‘a Convert Overlay to PFM ) 
OVErray terns ceuecceuesG ys en oe >: SMPLOVL 
EVDRORY a5. neeeseteotes at soe es : QGPL 


Type choices, press Enter. 


FOvmatisOr data: =: 4. « 6 << « 1=Fixed, 2=Continuous 
erates cor ean aes cre ig vee Name, *VM, *MVS 

LED AY Serer ech, sea scrseren ces roars *CURLIB Name, *CURLIB 
TO member 6% cee ae ww *OVL Name, *OVL 
Text 'description’..... *OVLTXT 
Replaces sty tt tunce to use nes ineusnne N Y=Yes, N=No 
Crestentive: Asie we wee Y Y=Yes, N=No 


Text 'description’ ..... 


F3=Exit F5=Refresh F12=Cancel ) 


Chapter 19. Work with Overlays Function 347 


The following table describes the Convert Overlay to File display. 


Table 74. Convert Overlay to File display fields 


Field Name 


Description 


Overlay 


Library 
Format of data 


To file 


Library 


Member 


Shows the name of the overlay to be converted to a physical file 
member. 

Shows the name of the library in which the overlay resides. 
Specifies how data is to be placed in the physical file member. 


The possible values are: 


1 One record has one structured field. The padding character 
is binary Os. The record length of the file using fixed format 
is the longest length of the AFPDS structured fields in the 
overlay. If the length of the existing file is smaller than the 
length of the longest structured field, an error message is 
displayed. If the length of the existing file is larger than the 
longest length of the structured field, padding characters are 
added to the end of the records. This format is for the VM 
or the MVS system. 


2 The structured fields are filled continuously and folded. 
Only the last record has padding characters; the padding 
characters are binary Os. Any record length of the existing 
file is allowed. The created record length of the file is 256 
bytes. This format is for the OS/2*. 


This is a required parameter. 
Specifies the qualified name of the physical file being used to place 
the overlay data. 


*VM Specifies that the name OVLY38PP is used. It will be a valid 
file type for an overlay on the VM system. 


*MVS Specifies that the name O1xxxxxx is used. The ’xxxxxx’ is 
the first six valid characters of the name specified in the 
Overlay prompt. It will be a valid member name for an 
overlay on the MVS system. 


file-name 
Specifies the file name in which to place the overlay data. 
The possible values are: 


*CURLIB 
The current library for the job is used to locate the file. If no 
library is specified as the current library for the job, QGPL 
is used. 


library-name 

Specify the library where the file resides. 
Specifies the name of the physical file member which is filled with 
the overlay data. 


The possible values are: 


*OVL = Specifies that the name of the overlay shown in the Overlay 
field is used. 


member-name 
Specify the member name to place the overlay data. 
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Table 74. Convert Overlay to File display fields (continued) 
Field Name Description 


Text ‘description’ Specifies text that briefly describes the member and its function. The 
description should be specified with no more than 50 characters of 
text and enclosed in apostrophes. 


The possible values are: 


*OVLTXT 
Specifies the same description of the overlay shown in the 
Overlay field is used. 


‘description’ 
Specify the description of the member. 
Replace Specifies whether or not the physical file member replaces the 


existing physical file member if a physical file member of the same 
name already exists in the library. 


The possible values are: 


N A new physical file member is not created if an old physical 
file member of the same name already exists in the library. 
Y 
A new physical file member is created and the old physical 
file member is replaced by it. 
Create file Specifies whether or not the file is created if the file does not exist. 


The possible values are: 


N Do not create the file. 
Y Create the file. 
Text ‘description’ Specify text that briefly describes the file and its function. This 


prompt is valid only when Y is specified in the Create file prompt. 
The description should be specified with no more than 50 characters 
of text and enclosed in apostrophes. 


13=Change Overlay Text 


To change an overlay text, do the following on the Work with Overlays display on 

page Bail 

1. Type 13 in the Opt column beside the overlay for which you want to change 
the description text. 


2. Press Enter. 


The CL command CHGOBUD is called. 
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Chapter 20. Work with Page Segments Function 


The work with page segments function allows you to copy, delete, rename, and 
print a page segment, display and change the description of a page segment, and 
convert a page segment to a physical file member from the list of page segments 
found in the selected libraries. 


To use the work with page segments function, type 23 on the Selection or 
command line on the IBM Advanced Function Printing Utilities for iSeries menu 
on page B24l and press Enter. The Work with Page Segments display appears: 


(i a 


Work with Page Segments 


IGID AV Votceten tea ioees testes *LIBL Name, *LIBL, *CURLIB 
*ALL, *USRLIBL, *ALLUSR 

Page-Segment: 2, 2 5 «. ms *ALL Name, generic*, *ALL 

Position’ toi. 4. &. 4. se Starting character(s) 


Type options, press Enter. 
3=Copy 4=Delete 6=Print 7=Rename 8=Display description 
9=Convert to file 13=Change text 


Page 
Opt Segment Library Text 
QFCPAGS QAFP SAMPLE PAGE SEGMENT - IM1 FORMAT 
QFCPAGS2 QAFP SAMPLE PAGE SEGMENT - IOCA FUNCTION SET 10 FORMAT 
BEAR QGPL bear 
QFCLOGO QGPL SAMPLE PAGE SEGMENT - IM1 FORMAT 
QFCLOGO2 QGPL SAMPLE PAGE SEGMENT - IOCA FUNCTION SET 10 FORMAT 


Bottom 
Parameters or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve  F1l=Display names only 
F12=Cancel 


Ns Ed 


The Work with Page Segments display shows a list of page segments in the 
libraries that you specified. If you specified a page segment name or generic name 
for the Page segment prompt, only those page segments that match the specified 
values are included in the list. 


You can copy, delete, rename, and print a page segment, display and change the 
description text of a page segment, and convert a page segment to a physical file 


member from the list of page segments. 


The following tables describe the Work with Page Segments display. 
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Prompts 


Table 75. Work with Page segments Function prompts 


Prompt 


Library 


Page segment 


Position to 


Description 


Specifies the names of the libraries that contains the page segments that 
you want to list. The possible library values in this prompt are: 


*LIBL The library list is used to create a list of the page segments. All 
page segments that reside in all libraries in the library list are 
included in the list. 


*USRLIBL 
The user portion of the library list is used to create a list of the 


page segments. 


*CURLIB 
The current library for the job is used to create a list of the page 
segments. If no library is specified as the current library for the 
job, library QGPL is used. 


*ALL All libraries in the system are used to create a list of the page 
segments. 


*ALLUSR 
All user libraries in the system are used to create a list of the 
page segments. All user libraries mean all libraries whose names 
do not start with Q in addition to library QGPL. 


Name The specified library is used to create a list of the page 
segments. 

Specifies the name of the page segment to be listed. You can use this 

prompt to work with page segments or a subset of page segments in the 

specified library. 


*ALL Specify *ALL for a list of all the page segments in the specified 
library. 


generic* 
Specify a partial page segment name qualified by an asterisk (*) 
to display a list of page segment names that start with the 
generic name. 


Name _ Specify the name of the page segment that you want to display 
in the list. 

This prompt is used for quick repositioning of the list, not for creating a 

subset of the list. Choose one of the following: 


*TOP Specify *TOP to go to the top of the list. 
*BOT Specify *BOT to go to the bottom of the list. 


name or partial name 
Specifies the name or partial name you want to go to in the list. 
The list is positioned to the first name beginning with the string 
specified. 
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Options 


Table 76. Work with Page segments Function options 


Option 
3=Copy 


4=Delete 


6=Print 


7=Rename 


8=Display 
description 


9=Convert to file 


13=Change text 


Description 


Using this option, you can copy a page segment using the Create 
Duplicate Object (CRTDUPOBJ) command. 


Specify 3 (Copy) in the Opt column beside the page segment you want to 
copy and press Enter. 


If the page segment is to be copied into a different library, the library 
must exist. If the library does not exist, create the library by entering the 
Create Library (CRTLIB) command on any display with a command line. 
Using this option, you can delete a page segment using the Delete Page 
Segment (DLTPAGSEG) command. 


Specify 4 (Delete) in the Opt column beside the page segment you want 
to delete and press Enter. 
Using this option, you can print a page segment. 


Specify 6 (Print) in the Opt column beside the page segment you want to 
print and press Enter. 
Using this option, you can rename a page segment. 


Specify 7 (Rename) in the Opt column beside the page segment you want 
to rename and press Enter. 

Using this option, you can display the description of a page segment 
using the Display Object Description (DSPOBJD) command. 


Specify 8 (Display description) in the Opt column beside the page 
segment for which you want to display the description and press Enter. 
Using this option, you can convert a page segment to a physical file 
member. 


Specify 9 (Convert to file) in the Opt column beside the page segment 
which you want to convert to a physical file member and press Enter. 
Using this option, you can change the description of a page segment 
using the Change Object Description (CHGOBJD) command. 


Specify 13 (Change description) in the Opt column beside the page 
segment for which you want to change the description and press Enter. 


Columns 


Table 77. Work with Page segments Function columns 


Column 
Opt 


Page segment 
Library 
Text 


Description 


Specify the number of the option beside the page segment that you want 
to work with. 

Shows the name of the page segments in the libraries that you specified. 
Shows the names of the libraries in which the page segments reside. 
Shows the text that describes the page segments. 
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3=Copy Page Segment 


To copy a page segment, do the following on the Work with Page Segments 
display on page Beil 
1. Type 3 in the Opt column beside the page segment that you want to copy. 


2. Press Enter. 


The CL command CRTDUPOBJ will be called. 


4=Delete Page Segments 


To delete a page = ie do the following on the Work with Page Segments 
display on page 
1. Type 4 in the Opt column beside the page segment that you want to delete. 


2. Press Enter. 


The Confirm Delete of Page Segments display appears: 


a 


Confirm Delete of Page Segments 


Press enter to confirm your choices for 4=Delete. 
Press Fl2 to return to change your choices. 


Page 
Opt Segment Library Text 
4 BEAR QGPL bear 


Bottom 
Fll=Display names only F12=Cancel 


XN 


On this display, all the page segments that you specified to be deleted on the 
previous display are listed. 


Press Enter to delete the page segments in the list or press F12 to cancel the 
deletion. When you press Enter, the CL command DLTPAGSEG is called. 
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The following table describes the Confirm Delete of Page Segments display. 
Table 78. Confirm Delete of Page Segments display fields 


Field Name Description 

Opt The Opt column shows the delete option. For this display, the 
number is always shown. 

Page segment The page segments which you specified to be deleted on the 
previous display are listed. 

Library The library that contains the page segments which you specified to 
be deleted on the previous display are listed. 

Text The text that describes the page segment which you specified to be 


deleted on the previous display is shown. 


6=Print Page Segment 


To print a page segment, do the following on the Work with Page Segments 
display on page Beil 

1. Type 6 in the Opt column beside the page segment that you want to print. 
2. Press Enter. 


The Print Page Segment display appears: 


Print Page Segment 


Page segment ........: BEAR 
EVDO ees seeteeri ewer cose QGPL 


Type choices, press Enter. 


Outputs queues. cs) a er Gas *JOB Name, *JOB 

LED ACV es saacwteeticmrss renee Name, *LIBL, *CURLIB 
COPeS: zis os ae eB ee ee 1 1-255 
Print: fidelity. 5 5 er oe se *CONTENT *CONTENT, *ABSOLUTE 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 


\ a 


The print page segment function allows you to print a page segment on an IPDS 
printer. 


From this display, you can specify the name of the output queue, the number of 
copies, and the print fidelity. 
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The following table describes the Print Page Segment display. 
Table 79. Print Page Segment display fields 


Field Name Description 

Page segment Shows the name of the page segment to be printed. 

Library Shows the name of the library in which the page segment resides. 

Output queue Specifies the name of the output queue in which the spooled file will be 
created. 


The possible values are: 


*JOB = Specifies that the output queue specified in the job description 
associated with this job is used. 


This is the default value. 


output-queue-name 
Specifies the name of the output queue to be used. 
Library Specifies the name of the library to locate the output queue. The 
possible predefined values are: 


*LIBL The library list is used to locate the output queue. 


*CURLIB 
The current library for the job is used to locate the output 
queue. If no library is specified as the current library for the 
job, library QGPL is used. 


library-name 
Specify the library where the output queue resides. 
Copies Specifies the number of copies you want to print. The range of valid 
values is 1 to 255. 
Print fidelity Specifies the degree of exactness required when printing the page 
segment. The possible predefined values are: 


*CONTENT 
Prints the overlay using all available exception handling. 


*ABSOLUTE 
The job is printed only if the overlay can be printed exactly as 
specified by the data stream and external controls. 


7=Rename Page Segment 


To rename a page segment, do the following on the Work with Page Segments 
display on page 

1. Type 7 in the Opt column beside the page segment that you want to rename. 
2. Press Enter. 


The CL command RNMOBJ will be called. 


8=Display Page Segment Description 
To display a page segment description, do the following on the Work with Page 
Segments display on page 
1. Type 8 in the Opt column beside the page segment name for which you want 
to display the description. 


2. Press Enter. 
The CL command DSPOBUD will be called. 


356 AFP Utilities for iSeries: User’s Guide 


9=Convert Page Segment to Physical File Member 


To convert a page segment to a physical file member, do the following on the Work 
with Page Segments display on page 


Note: You have to check the version and the supported structured fields of the 
target system’s Print Services Facility. 


A page segment which can be used on the iSeries system cannot necessarily 
be used on the target system. 
1. Type 9 in the Opt column beside the name of the page segment which you 
want to convert to a physical file member. 


2. Press Enter. 


The following display appears: 


‘a Convert Page Segment to PFM ) 


Page segment. .......: QFCLOGO 
EVbRaey” ori rsereanee ah were tens QGPL 


Type choices, press Enter. 


FOvmnat-sOf data =. 4. = 4 <x 1=Fixed, 2=Continuous 
Oia S cote ae! arse ese Name, *VM, *MVS 

[ETD Ia iieeee ce. teacersires, co sure *CURLIB Name, *CURLIB 
TOMMEMbDEM = 2. 4s Sez vente a: os *PAGSEG Name, *PAGSEG. 
Text 'description’..... *PSGTXT 
Replaces 2 tute eats tk ees N Y=Yes, N=No 
Greater files tes: we ee 6 es N Y=Yes, N=No 


F3=Exit F5=Refresh F12=Cancel 
SD 


1. Type data in the prompts. 
2. Press Enter. 


A Text ‘description’ prompt for the file appears when you specify ’Y in the Create file 
prompt: and press enter. 
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i Convert Page Segment to PFM >) 
Page segment ea eee Se  QFCLOGO 
[END a Vintesdccses <curee-s eee ss QGPL 
Type choices, press Enter. 
Format of data. « «ss « « 1=Fixed, 2=Continuous 
iG eT TE a ies ne are arse heise re Name, *VM, *MVS 
[DRARV yz ceccsc ns es tees, ee *CURLIB Name, *CURLIB 
To member 4 a wee ee *PAGSEG Name, *PAGSEG. 
Text ‘description’ ..... *PSGTXT 
REplaGes sce sects ceees elas an ae N Y=Yes, N=No 
Create file: kgs eon is y Y=Yes, N=No 
Text 'description’'..... 
F3=Exit F5=Refresh  F12=Cancel 
XN yy 


The following table describes the Convert Page Segment to File display. 


Table 80. Convert Page Segment to Files display fields 


Field Name 


Description 


Page segment 


Library 
Format of data 


Shows the name of the page segment to be converted to a physical file 
member. 

Shows the name of the library in which the page segment resides. 
Specifies how data is to be placed in the physical file member. 


The possible values are: 


1 Each record has one structured field. The remainder of the 
record is padded with binary Os. The record length of the file 
using fixed format is the length of the longest AFPDS 
structured field in the page segment. If the record length of 
the existing file is less than the length of the longest 
structured field, an error message is displayed. If the record 
length of the existing file is more than the length of the 
longest structured field, padding with binary Os occurs. This 
format is for the VM or the MVS system. 


2 The structured fields are filled continuously and folded. Only 
the last record has padding characters; the padding characters 
are binary Os. Any record length of the existing file is allowed. 
If the file is created by, the record length of the file is 256 
bytes. This format is for the OS/2*. This is a required 
parameter. 
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Table 80. Convert Page Segment to Files display fields (continued) 


Field Name Description 
To file Specifies the qualified name of the physical file being used to place the 
page segment data. 

The possible values are: 

*VM Specifies that the name PSEG38PP is used. It will be a valid 
file type for a page segment on the VM system. 

*MVS __ Specifies that the name S1xxxxxx is used. The ’xxxxxx’ are the 
first six valid characters of the name specified in the Page 
segment prompt. It will be a valid member name for a page 
segment on the MVS system. 

file-name 
Specifies the file name to place the page segment data. 

Library The possible values are: 

*CURLIB 
The current library for the job is used to locate the file. If no 
library is specified as the current library for the job, library 
QGPL is used. 

library-name 
Specify the library where the file resides. 

Member Specifies the name of the physical file member which is filled with the 


Text ‘description’ 


Replace 


page segment data. 


The possible values are: 


*PAGSEG 
Specifies that the name of the page segment shown in the 
Page segment field is used. 


member-name 

Specifies the member name to place the page segment data. 
Specifies text that briefly describes the member and its function. The 
description should be specified with no more than 50 characters of text 
and enclosed in apostrophes. 


The possible values are: 


*PSGTXT 
Specifies the same description of the page segment shown in 
the Page segment field. 


‘description’ 

Specifies the description of the member. 
Specifies whether or not a physical file member of the same name 
which already exists in the same file and library is to be replaced. 


The possible values are: 


N A new physical file member is not created if an old physical 
file member of the same name already exists in the file and 
library. 

Y A new physical file member is created which replaces the old 


physical file member. 
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Table 80. Convert Page Segment to Files display fields (continued) 


Field Name 


Description 


Create file 


Text ‘description’ 


Specifies whether or not the file is created if the file does not exist. 


The possible values are: 


N Do not create the file. 


Y Create the file. 

Specifies text that briefly describes the file and its function. This 
prompt appears only when Y is specified in the Create file prompt. The 
description should be specified with no more than 50 characters of text 
and enclosed in apostrophes. 


13=Change Page Segment Text 
To change a page segment ee text, do the following on the Work with 


Page Segments display on page 


1. Type 13 in the Opt column beside the page segment for which you want to 
change the description text. 


2. Press Enter. 


The CL command CHGOBUD will be called. 
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Chapter 21. AFP Utilities for iSeries Commands 


This chapter describes the commands for AFP Utilities for iSeries. The AFP Utilities 
for iSeries provide the following eight commands: 


STRAFPU 
STROVLU 
STRPFU 
PRIPFDDTA 
CVTPCDPAGS 
CVTPFMPAGS 
CVTOVLPFM 
CVTPAGSPFM 


You can enter the above commands on any display that contains the command 
line. 


STRAFPU (Start AFP Utilities for iSeries) Command 


The STRAFPU command displays the IBM Advanced Function Printing Utilities 
for iSeries menu that allows you to use the AFP Utilities functions. 


There are no parameters for this command. 


STROVLU (Start Overlay Utility) Command 


STROVLU command allows you to perform an option of the Overlay Utility 
directly without viewing the Work with Source Overlays display. 
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The following figure shows the command syntax for STROVLU command. 


Kee eee ee ee en a a * 
STROVLU----------------------------------------------------------- > 
| Required 
Option 
*->*PRVx----------------------------------------- * 
>--FILE--* *--->*LIBL/*------- * *oseesses > 
*--+----*CURLIB/*----- +*source-overlay-file-namex* 


| | 
| *---*] ibrary-name/** | 
| | 


*-->*PRV*----------------- * 
>--MBR--+--**SELECT*-------------- 4+-------------------------------- > 
*--*Source-overlay-name*--* 
*->*BLANK--* 
>--OPTION--+--1------ #4+--------------------------------------------- 
#-S2 saseese * 
| a one | 
| tonnnnnonas | 
#=--§---=-=- * 
| ee | 
#o-Qe-ceess * 
| een nen een a) 
| Job: I Pgm: I REXX: I Exec | 
Keene ee ee ee ee * 
Kee ee ee a ee ee * 


Figure 27. Command Syntax for STROVLU Command 


The following describes the parameters for STROVLU command. 
Source overlay file (FILE) 


Specifies the source overlay file and library that contain the source overlay 
to be worked with. 


The possible values are: 


*PRV 


Specifies that the Overlay Utility is to use the name of the source 
overlay file and library used in your last overlay utility session. If 
you specify *PRV for the FILE parameter, it is not necessary to 
specify a library. 


source-overlay-file-name 
Specify the name of an existing source overlay file to be used. If 
you specify the source-overlay-file-name and a library name, 
Overlay Utility searches the specified library for the source overlay 
file. If you do not specify a library name, *LIBL is used. 


The possible library values are: 


*LIBL 
The library list is used to locate the file. 


*CURLIB 
The current library for the job is used to locate the file. If no 
library is specified as the current library for the job, library QGPL 
is used. 


library-name 
Specify the library where the file is located. 
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Source overlay (MBR) 


Specifies the name of the source overlay to be worked with or created. The 
default value for this parameter depends on whether or not you specify 
the FILE parameter. 


The possible values are: 


*SELECT 
This is the default value if you specify the FILE parameter. If you 
choose *SELECT, you will get the lists of all source overlays in the 
specified source overlay file and library. Select one or more source 
overlays to work with on the display. 


*PRV_ This is the default value if you do not specify the FILE parameter. 
*PRV is the name of the previous source overlay that was used. 


This is the default value if you do not specify the FILE parameter. 
*PRV is the name of the previous source overlay that was used. 


source-overlay-name 
Specify the name of the source overlay you want to work with. 


Option (OPTION) 
Specifies the function to perform on the selected source overlay. 
The possible values are: 


*BLANK or ’’ 
This is the default value if you do not specify a source overlay 
name. *BLANK specifies no action. 


1=Create 
Type 1 to create a source overlay. 


2=Change 
This is the default value if you specify a source overlay name. 
Type 2 to change a source overlay. 

3=Copy 
Type 3 to copy a source overlay. 


4=Delete 
Type 4 to delete a source overlay. 


6=Print 
Type 6 to print a source overlay. 


7=Rename 
Type 7 to rename a source overlay. 


9=Create overlay 
Type 9 to create an overlay from a source overlay. 


STRPFU (Start Print Format Utility) Command 


This command allows you to perform an option of Print Format Utility directly 
without viewing the Work with PFD Definitions display. Figure 28 on the 
following page shows the command syntax for STRPFU command. 
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GTR PP amaceacwcc ceca neenncncndecwewseenecawewn deeeeewacencsemenne > 


Required 
www ww we ee ee ew ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee ee eee eee ee ee ee eee ee ee * 
Optional 
*->*PRV--------------------------- +--+ =e * 
>--PFDFILE*----* *->*LIBL/*--------- * kon--> 
*--+--*CURLIB/*------- +--PFD-definition-file-name---* 
*-*] ]brary-name/*--* 
*->*PRV----------------- * 
>--PFDMBR------ +->*SELECT-------------- Honsoes2- Hele ais 2-2 eo > 


*--PFD-definition-name--* 


#->*BLANK#* 


>--OPTION*-+--1------ he de sed cae co eeS eae ascseoseeeasee<atse-seceeensese5 * 
hue) hones * 
*-*3x*----- * 
*-*4x----- * 
*-*6§*----- * 
*-*]*----- * 
*-*Qk----- * 
Wess seceowee see see S se esSsoeeee sce sees * 
| Job: I Pgm: I REXX: I Exec 
Hosea eseessssessssseseseseceeesssees * 


Figure 28. The Command Syntax for STRPFU Command 


The following describes the parameters for STRPFU command. 
PFD file (PFDFILE) 


Specifies the PFD definition file and library that contain the PFD definition 
to be worked with. 


The possible values are: 


*PRV_ Specifies that the Print Format Utility is to use the name of the 
PFD definition file and library used in your last Print Format 
Utility session. If you specify *PRV for the PFDFILE parameter, it is 
not necessary to specify a library. 


PFD-definition-file-name 
Specify the name of an existing PFD definition file to be used. If 
you specify the PFD-definition-filename and a library name, Print 
Format Utility searches the specified library for the PFD definition 
file. If you do not specify a library name, *LIBL is used. 


The possible library values are: 


*LIBL 


The library list is used to locate the file. 


*CURLIB 
The current library for the job is used to locate the file. If 
no library is specified as the current library for the job, 
library QGPL is used. 


library-name 
Specify the library where the file is located. 
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PFD definition (PFDMBR) 


Specifies the name of the PFD definition to be worked with or created. The 
default value for this parameter depends on whether or not you specify 
the PFDFILE parameter. 


The possible values are: 
*SELECT 


This is the default value if you specify the PFDFILE parameter. If 
you choose *SELECT, you will get the lists of all PFD definitions in 
the specified PFD definition file and library. Select one or more 
PFD definitions to work with on the display. 


*PRV 


This is the default value if you do not specify the PFDFILE 
parameter. *PRV is the name of the previous PFD definition that 
was used. 


PFD-definition-name 
Specify the name of the PFD-definition you want to work with. 
Option (OPTION) 


Specifies the function to perform on the selected PFD definition. The 
default value depends on if you specify a PFD definition name. 


The possible values are: 


*BLANK or’ ’ 
This is the default value if you do not specify a PFD definition 
name. *BLANK specifies no action. 


1=Create 
Type 1 to create a PFD definition. 


2=Change 
This is the default value if you specify a PFD definition name. 
Type 2 to change a PFD definition. 

3=Copy 
Type 3 to copy a PFD definition. 


4=Delete 

Type 4 to delete a PFD definition. 
6=Print 

Type 6 to print a PFD definition. 


7=Rename 
Type 7 to rename a PFD definition. 


9=Print database file 
Type 9 to print a database file member by using a PFD definition. 


PRTPFDDTA (Print PFD Data) Command 


This command allows you to print a database file member according to the design 
of a PFD definition. 


The following figure shows the command syntax for PRTPFDDTA command. 
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*LIBL/ -------- 
PRTPFDDTA----PFDFILE- --*CURLIB/-- ---- --PFD-definition-file-name--- 
- library-name/ - 
Required 
Optional 
*FIRST----------------- |P| 
--PFDMBR ---- ween penn nnn n--------------- 
--PFD-definition-name---- 
soxPPDseses ceccssececesssedseecsssssce 
| -*LIBL/--------- 
--FILE---- --- -- *CURLIB/------- --- file-name----- -------------------- 
--library-name/-- 
-*FIRST---------- 
--MBR--- wee nn nn nn nn-------------------------------- 
--member-name----- 
-*NO-- 
---GRID---- = ------- ------------------------------------------- 
--*YES- 
---*YES- -*END-------- 
---RCDSLT-- ss ==------ -- ENDPAGE--- wenn nnn -------- 
~-«NO-- page-number - 
VcLePED ose eoeae eae 
---DRAWER-- - *E] -------------- --------------------------------------- 
= *C(U7T =--=--------=+- 
--print-drawer ----- 
---*DEVD--------- ---*PFD-------------- 
---OUTBIN-- wen nnn n= COPIES-- ww eene 
--output-bin---- --number-of-copies-- 
amen KIQR seossoseseeseese eee eceesee cece esennen 
---OUTQ= nnn nnn nnnn--- 
| ---*LIBL/ --------- 
- --*CURLIB/-------- ---- output-queue ------- 
--library-name --- 
beoe PPD sesese seo cennes esa datete ont casos soneeaseaseo 
---FORMDF-- - *INLINE ------------------------------------------ -------- 
| ---*LIBL/ --------- 
- --*CURLIB/-------- ---- form-definition-name------ 
--library-name --- 
| Job: B, I Pgm: B, I REXX: B, I Exec | 


Figure 29. The Command Syntax for PRTPFDDTA Command 


The following describes the parameters for PRTPFDDTA command. 
PFD file (PFDFILE) 


Specifies the PFD definition file and library that contain the PFD definition 
to be used. 


The possible values are: 
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PFD-definition-file-name 
Specify the name of an existing PFD definition file to be used. If 
you specify the PFD-definition-filename and a library name, Print 
Format Utility searches the specified library for the PFD definition 
file. If you do not specify a library name, *LIBL is used. 


The possible library values are: 
*LIBL_ The library list is used to locate the file. 


*CURLIB 
The current library for the job is used to locate the file. If 
no library is specified as the current library for the job, 
library QGPL is used. 


library-name 
Specify the library where the file is located. 


PFD definition (PFDMBR) 


Specifies the name of the PFD definition to be used to print a database file 
member. 


The possible values are: 


*FIRST 
This is the default value. The first PFD definition in the PFD 
definition file is used. 

PFD-definition-name 
Specify the name of the PFD-definition you want to use. 


Database file (FILE) 


Specifies the database file and library that contain the member to be 
printed. 


The possible values are: 


*PFD Specifies that the database file and library that are specified in the 
PFD definition is printed. 


file-name 
Specify the name of an existing database file to be used. If you 
specify the file-name and a library name, Print Format Utility 
searches the specified library for the database file. If you do not 
specify a library name, *LIBL is used. 


The possible library values are: 
*LIBL The library list is used to locate the file. 


*CURLIB 
The current library for the job is used to locate the file. If 
no library is specified as the current library for the job, 
library QGPL is used. 


library-name 
Specify the library where the file is located. 
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Member (MBR) 
Specifies the name of the member to be printed. 


The possible values are: 


*FIRST 
This is the default value. The first member in the database file is 
printed. 


member-name 
Specify the name of the member you want to print. 


Include grid (GRID) 


Specifies whether a grid is included in the printout or not. A grid consists 
of horizontal lines and vertical lines, and the distance between horizontal 
lines and that between vertical lines are specified in the PFD specifications. 


The possible values are: 
*NO _ This is the default value. A grid is not included in the printout. 
*YES A grid is included in the printout. 

Record selection (RCDSLT) 


Specifies whether the records are selected according to the selection 
conditions specified in the PFD definition or not. 


The possible values are: 


*YES Type *YES if you want to select and print only those records that 
match the selection conditions specified in the PFD definition. 


All records are printed if no conditions are specified in the PFD 
definition. 


*NO __ Type *NO if you want to print all records regardless of the 
selection conditions specified in the PFD definition. 


Ending page (ENDPAGE) 


Specifies whether printing should stop at a certain page or continue until 
all records are processed. 


The possible values are: 
*END Specifies to print until all records are processed. 


page-number 
Specify the last page number to be printed. Print Format Utility 
stops printing when the last page specified by this parameter is 
printed or all records have been processed. 


The possible value range is 1 - 9999. 
Source drawer (DRAWER) 


Specifies the source drawer used when single-cut sheets are fed into the 
printer. The possible values are: 


*PFD The value specified in the printout specification is used. *PFD is 
the default. 


*E1 Envelopes are fed from the envelope drawer on the sheet-feed 
paper handler. 
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*CUT For printers with manual feed, cut sheets are fed manually through 
the manual feeder. 


PV.source-drawer 
Specify the drawer from which the paper is fed. Valid values range 
from 1 through 255. For printers with manual feed, specifying 100 
is the same as specifying *CUT. 


Output bin (OUTBIN) 


Specifies the destination of the output on printers capable of multiple 
output bins. The possible values are: 


*DEVD 
The value specified in the Device description is used. *DEVD is the 
default. 


output bin 
Specify the output bin for the destination of the output. Valid 
values range from 1 through 65535. 


Copies (COPIES) 
Specifies the number of copies to be printed. 
The possible values are: 
*PFD Specifies that the number specified in the PFD definition is used. 
This is the default value. 


number-of-copies 
Specify the number of copies to be printed. 


The possible value range is 1 - 255. 
Output queue (OUTQ) 


Specifies the qualified name of the output queue in which the spooled file 
will be created. 


The possible values are: 


*JOB Specifies the output queue specified in the job description 
associated with this job is used. 


This is the default value. 


output-queue-name 
Specifies the name of the output queue to be used. 


The possible library values are: 
*LIBL The library list is used to locate the output queue. 


*CURLIB 
The current library for the job is used to locate the output 
queue. If no library is specified as the current library for 
the job, library QGPL is used. 


library-name 
Specify the library where the output queue is located. 
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Form definition (FORMDF) 


Specifies the qualified name of the form definition to use when printing 
the spooled file. 


The possible values are: 


*PFD Specifies that the form definition and library that are specified in 
the PFD definition will be used to print the member. 


This is the default value. 


*DEVD 
Specifies that the form definition specified in the device description 
for the printer will be used. 


*INLINE 
Specifies that the Print Format Utility will create an inline form 
definition to be used when printing the data. The page width and 
length specified in the printout format definition will be placed in 
the created form definition for page control with continuous form 
printers. These values will be used when the page size control 
value for the printer is set to *YES. Use the Work with PSF 
Configurations (WRKPSFCFG) command to set the page size 
control value. 


form-definition-name 
Specifies the name of the form definition to be used. 


The possible library values are: 
*LIBL The library list is used to locate the form definition. 


*CURLIB 
The current library for the job is used to locate the form 
definition. If no library is specified as the current library 
for the job, library QGPL is used. 


library-name 
Specify the library where the form definition is located. 


CVTPCDPAGS (Convert PC Document to Page Segment) Command 


CVTPCDPAGS command allows you to convert a PC document in a folder to a 
page segment. The PC document must contain IMDS (Image Data Stream) format 
image data or Image Object Content Architecture (IOCA) function set 10 data. 


The following figure shows the command syntax for the CVTPCDPAGS command. 
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CVTPCDPAGS----- PAGSEG--- ---*CURLIB/------ --- 
--- - page-segment-name-- 
- library-name - 


Required 
Optional 
er *PRV------- -----«PRV ------------- |P| 
----FRMFLR-- -FRMDOC- -*PAGSEG------------- --- - ---------- 
--folder-name- --PC-document-name -- 
----*SAME- 
----CHGIMGSIZE-- --*NO--- ------------------------------------------------- 
--*YES-- 
(1) ----*SAME-- ----*SAME------- ----*SAME--------- 
----IMGSIZE-- --*INCH-- --- ee wenn nn nnn 
--*(M---- --width-value- --length-value-- 


(1) -+--*SAME - 
seo MAPPING =: nxtP MT cen) necadcnsdneneresnseweterebaevenvarendesnednnedene 
=-#5$TFo== 
= #CAT=<< 
- *IPTP-- 
- *IPTPD- 


~---%*SAME - 
SROMINGRTT 2 eoQeeeciedt Spbsbnesiee een ee so pede eteeeiebeadt seteeeec cee 


= 180-== 
=/970-= 


-- name -------- 
= #SAME =<a2e=2== wsenkYES. 


----TEXT - -- *BLANK -------- ------ REPLACE - swe === === ------- 
-- 'description'-- - *NO -- 


(1) CHGIMGSIZE='*YES' only 


Figure 30. The Command Syntax for CVTPCDPAGS Command 


The following describes the parameters for CVTPCDPAGS command. 
Page segment (PAGSEG) 


Specifies the qualified name of the page segment to be created. This is a 
required parameter. 


The possible values are: 


*PRV_ Specifies that the name of the page segment and library used when 
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you performed this command last is used. If you specify *PRV for 
the PAGSEG parameter, it is not necessary to specify a library. 


page-segment-name 
Specify the name of the page segment to be created. 
The possible library values are: 


*CURLIB 
The current library for the job is used to create the page 
segment. If no library is specified as the current library for 
the job, library QGPL is used. 


library-name 
Specify the library in which the page segment will be 
created. 


From folder (FRMFLR) 


Specifies the name of the folder that contains the PC document to be 
converted. 


The possible values are: 


*PRV_ Specifies the name of the folder used when you previously created 
a page segment of the same name. 


folder-name 
Specify the folder name. 


From PC document (FRMDOC) 
Specifies the PC document name to be converted. 
The possible values are: 


*PRV_ Specifies the name of the PC document used when you previously 
created a page segment of the same name. 


*PAGSEG 
Specifies that the name of the page segment to be created is the 
same as the name of the PC document. 


PC-document-name 
Specify the PC document name that is to be converted. 


Change image size (CHGIMGSIZE) 


Specifies whether the size of the image in the page segment is changed or 
not. 


The possible values are: 


*SAME 
Specifies the same value used for this parameter when you 
previously created a page segment of the same name. If this is the 
first page segment, the default value is *NO. 


*NO _ Specifies not to change the image size. 
*YES Specifies to change the image size. 


If you specify *YES, the IMGSIZE and MAPPING parameters will 
appear, and you can specify the new image size in the page 
segment and how to map the input image to the size. 
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Image area size (IMGSIZE) 


Specifies the unit of measurement, width, and length of the image to be 
created in the page segment. 


Unit of measure 
Specifies the unit of measure used to specify the following two 
parameters. 


The possible values are: 


*SAME 
Specifies the unit of measure used when you previously 
created a page segment of the same name. 


*INCH 
Inch is used as the unit of measure. 


*CM Centimeter is used as the unit of measure. 
Width Specifies the width of the image to be created. 
The possible values are: 


*SAME 
Specifies the value of the width used when you previously 
created a page segment of the same name. 


width-value 
Specify the width value in the selected unit of measure. 


Length 
Specifies the length of the image to be created. 


The possible values are: 


*SAME 
Specifies the value of the length used when you previously 
created a page segment of the same name. 


length-value 
Specify the length value in the selected unit of measure. 


Mapping option (MAPPING) 


Specifies how the input image is mapped to the specified size of the 
output image in the page segment. 


The possible values are: 


*SAME 
Specifies the mapping option used when you previously created a 
page segment of the same name. 


*PAT (Position and trim) 
The top left corner of the input image is located to the top left 
corner of the output image area. The image size is not changed, 
and any portion of the input image that falls outside of the output 
image size is trimmed. 


*STF (Scale to fit) 
The center of the input image is located to the center of the output 
image area. The image size is changed so that the input image fits 
in the output image size. 
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*CAT (Center and trim) 
The center of the input image is located to the center of the output 
image area. The image size is not changed, and any portion of the 
input image that falls outside of the output image size is trimmed. 


*IPTP (Image point to pel) 
The top left corner of the input image is located to the top left 
corner of the output image area. No resolution correction is done 
and each image point in the input image is mapped to a pel of the 
output printer. The image size may vary depending on the 
pel-density of the output printer, and any portion of the input 
image that falls outside of the output image size is trimmed. 


*IPTPD (Image point to pel with double dot) 
The top left corner of the input image is located to the top left 
corner of the output image area. No resolution correction is done 
and each image point in the input image is doubled (replicated) in 
both dimensions and mapped to pels of the output printer. The 
image size may vary depending on the pel-density of the output 
printer, and any portion of the input image that falls outside of the 
output image size is trimmed. 


Degree of rotation (IMGRTT) 


Specifies the degree of the clockwise rotation of the output image. The 
center of the rotation is the top left corner of the image. 


The possible values are: 


*SAME 
Specifies the degree of rotation used when you previously created 
a page segment of the same name. 

0 No rotation is done. 

90 The image is rotated 90 degrees clockwise. 


180 The image is rotated 180 degrees clockwise. 
270 The image is rotated 270 degrees clockwise. 
Authority (AUT) 


Specifies the authority given to the user who does not have specific 
authority, who is not on the authorization list, or whose user group has no 
specific authority to the created page segment. 


Note: This value is ignored and the current authority remains when you 
replace the existing page segment. 


The possible values are: 


*SAME 


Specifies the same value used for this parameter when you 
previously created a page segment of the same name. If this is the 
first page segment, the default value is *LIBCRTAUT. 


*LIBCRTAUT 
The system determines the authority for the page segment by 
using the value specified for the Create authority prompt (CRTAUT 
parameter) on the Create Library command (CRTLIB) for the 
library containing the page segment to be created. If the value 
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specified on the Create authority prompt (CRTAUT parameter) is 
changed, the new value will not affect this page segment. 


*CHANGE 
Change authority allows the user to perform all operations on the 
page segment except those limited to the owner or controlled by 
object existence authority and object management authority. The 
user can change the page segment and perform basic functions on 
the page segment. Change authority provides object operational 
authority and all data authority. 


*ALL All authority allows the user to perform all operations on the page 
segment except those limited to the owner or controlled by 
authorization list management authority. The user can control the 
page segment’s existence, specify the security for the page 
segment, change the page segment, and perform basic functions on 
the page segment. The user cannot transfer ownership of the page 
segment. 


*USE Use authority allows the user to perform basic operations on the 
page segment, such as read the page segment. The user is 
prevented from changing the page segment. Use authority provides 
object operational authority, read authority, and execute authority. 


*EXCLUDE 
Exclude authority prevents the user from accessing the page 
segment. 


authorization-list-name 
Specify the name of an authorization list. Users included on the 
authorization list are granted authority to the page segment as 
specified by the list. The authorization list must exist when the 
page segment is created. 


Text ‘description’ (TEXT) 
Specifies text that briefly describes the page segment to be created. 
The possible values are: 


*SAME 
Specifies the text used when you previously created a page 
segment of the same name. 


*BLANK 
Specifies the text is blank. 


‘description’ 
Specify no more than 50 characters of text, enclosed in 
apostrophes. 


Replace (REPLACE) 


Specifies whether or not the page segment replaces the existing page 
segment if a page segment of the same name already exists in the library. 


The possible values are: 


*YES Anew page segment is created and the old page segment is 
replaced by it. 


*NO_ Anew page segment is not created if an old page segment of the 
same name already exists in the library. 
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CVTPFMPAGS (Convert Physical File Member to Page Segment) 
Command 


This command allows you to convert a member in a physical database file to a 
page segment. The member must contain IMDS (Image Data Stream) format or 
IOCA function set 10 image data. 


The following figure shows the command syntax for CVTPFMPAGS command. 
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CVTPFMPAGS----- PAGSEG--- ----*CURLIB/------= wwe 
--- - page-segment-name- 
- library-name - 


Required 
Optional 
oeeee APRY ise wea seeso-haeh eos oe ne 
| ----*PRY ------- |P| 
----FILE -  ----*LIBL/-------- -- MBR - - *PAGSEG ---- - - -- 
- --*CURLIB/------ -- file-name - - member-name 
--library-name/- 
----*NO--- 
----CHGIMGSIZE-- we ono ono -------- +--+ --- -- + = ---- = --------------- 
--*YES-- 
(1) ----*SAME-- ----*SAME------- ----*SAME--------- 
----IMGSIZE-- --*INCH-- --- eee nnn n nee 
--*(M---- --width-value- --length-value-- 


(1) -+--*SAME - 
daeMAPPING & an@PM ran. thandGntandcntcmenacndescnhncdsudecedaseasckmexen ce 

ss#8T Pao 

- *CAT--- 

- *IPTP-- 

- *IPTPD- 


~---*SAME - 
SCRCINGRTT SS seQewetee: sie ti ceeteeditewseittneetenad eecacveseasceeeeweeus 


~ 1805-42 
= 970=-= 


-- name -------- 
— *SAME <os2-ns-5 aaes8VES = 


----TEXT - -- *BLANK -------- ------ REPLACE - 2s wwe wenn ---------- 
-- 'description'-- - *NO -- 


(1) CHGIMGSIZE='*YES' only 


Figure 31. The Command Syntax for CVTPFMPAGS Command 


The following describes the parameters for CVTPFMPAGS command. 
Page segment (PAGSEG) 


Specifies the qualified name of the page segment to be created. This is a 
required parameter. 


The possible values are: 
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*PRV Specifies that the name of the page segment and library used when 
you performed this command last is used. If you specify *PRV for 
the PAGSEG parameter, it is not necessary to specify a library. 

page-segment-name 
Specify the page segment name to be created. 


The possible library values are: 


*CURLIB 
The current library for the job is used to create the page 
segment. If no library is specified as the current library for 
the job, library QGPL is used. 


library-name 
Specify the library in which the page segment will be 
created. 


From file (FILE) 


Specifies the qualified name of the physical file that contains the member 
to be converted. 


The possible values are: 


*PRV_ Specifies the file and library used when you previously created a 
page segment of the same name. 


file-name 
Specify the name of an existing physical database file to be used. If 
you do not specify a library name, *LIBL is used. 


The possible library values are: 
*LIBL The library list is used to locate the file. 


*CURLIB 
The current library for the job is used to locate the file. If 
no library is specified as the current library for the job, 
library QGPL is used. 


library-name 
Specify the library where the file is located. 


From member (MBR) 
Specifies the name of the physical file member to be converted. 
The possible values are: 


*PRV Specifies the member name used when you previously created a 
page segment of the same name. 


*PAGSEG 
Specifies that the name of the page segment to be created is the 
same as the name of the member. 


member-name 
Specify the member name that is to be converted. 


Change image size (CHGIMGSIZE) 
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Specifies whether the size of the image in the page segment is changed or 
not. 


The possible values are: 


*SAME 
Specifies the same value used for this parameter when you 
previously created a page segment of the same name. If this is the 
first page segment, the default value is *NO. 


*NO _ Specifies not to change the image size. 
*YES Specifies to change the image size. 


If you specify *YES, the IMGSIZE and MAPPING parameters will 
appear, and you can specify the new image size in the page 
segment and how to map the input image to the size. 


Image area size (IMGSIZE) 


Specifies the unit of measurement, width, and length of the image to be 
created in the page segment. 


Unit of measure 
Specifies the unit of measure used to specify the following two 
parameters. 


The possible values are: 


*SAME 
Specifies the unit of measure used when you previously 
created a page segment of the same name. 


*INCH 
Inch is used as the unit of measure. 


*CM Centimeter is used as the unit of measure. 
Width Specifies the width of the image to be created. 
The possible values are: 


*SAME 
Specifies the value of the width used when you previously 
created a page segment of the same name. 


width-value 
Specify the width value in the selected unit of measure. 


Length 
Specifies the length of the image to be created. 


The possible values are: 


*SAME 
Specifies the value of the length used when you previously 
created a page segment of the same name. 


length-value 
Specify the length value in the selected unit of measure. 


Mapping option (MAPPING) 


Specifies how the input image is mapped to the specified size of the 
output image in the page segment. 


The possible values are: 
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*SAME 


Specifies the mapping option used when you previously created a 
page segment of the same name. 


*PAT (Position and trim) 
The top left corner of the input image is located to the top left 
corner of the output image area. The image size is not changed, 
and any portion of the input image that falls outside of the output 
image size is trimmed. 


*STF (Scale to fit) 
The center of the input image is located to the center of the output 
image area. The image size is changed so that the input image fits 
in the output image size. 


*CAT (Center and trim) 
The center of the input image is located to the center of the output 
image area. The image size is not changed, and any portion of the 
input image that falls outside of the output image size is trimmed. 


*IPTP (Image point to pel) 
The top left corner of the input image is located to the top left 
corner of the output image area. No resolution correction is done 
and each image point in the input image is mapped to a pel of the 
output printer. The image size may vary depending on the 
pel-density of the output printer, and any portion of the input 
image that falls outside of the output image size is trimmed. 


*IPTPD (Image point to pel with double dot) 
The top left corner of the input image is located to the top left 
corner of the output image area. No resolution correction is done 
and each image point in the input image is doubled (replicated) in 
both dimensions and mapped to pels of the output printer. The 
image size may vary depending on the pel-density of the output 
printer, and any portion of the input image that falls outside of the 
output image size is trimmed. 


Degree of rotation (IMGRTT) 


Specifies the degree of the clockwise rotation of the output image. The 
center of the rotation is the top left corner of the image. 


The possible values are: 


*SAME 
Specifies the degree of rotation used when you previously created 
a page segment of the same name. 


0 No rotation is done. 

90 The image is rotated 90 degrees clockwise. 

180 The image is rotated 180 degrees clockwise. 

270 The image is rotated 270 degrees clockwise. 
Authority (AUT) 


Specifies the authority given to the user who does not have specific 
authority, who is not on the authorization list, or whose user group has no 
specific authority to the created page segment. 
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Note: This value is ignored and the current authority remains when you 
replace the existing page segment. 


The possible values are: 


*SAME 
Specifies the same value used for this parameter when you 
previously created a page segment of the same name. If this is the 
first page segment, the default value is *LIBCRTAUT. 


*LIBCRTAUT 
The system determines the authority for the page segment by 
using the value specified for the Create authority prompt (CRTAUT 
parameter) on the Create Library command (CRTLIB) for the 
library containing the page segment to be created. If the value 
specified on the Create authority prompt (CRTAUT parameter) is 
changed, the new value will not affect this page segment. 


*CHANGE 
Change authority allows the user to perform all operations on the 
page segment except those limited to the owner or controlled by 
object existence authority and object management authority. The 
user can change the page segment and perform basic functions on 
the page segment. Change authority provides object operational 
authority and all data authority. 


*ALL All authority allows the user to perform all operations on the page 
segment except those limited to the owner or controlled by 
authorization list management authority. The user can control the 
page segment’s existence, specify the security for the page 
segment, change the page segment, and perform basic functions on 
the page segment. The user cannot transfer ownership of the page 
segment. 


*USE Use authority allows the user to perform basic operations on the 
page segment, such as read the page segment. The user is 
prevented from changing the page segment. Use authority provides 
object operational authority, read authority, and execute authority. 


*EXCLUDE 
Exclude authority prevents the user from accessing the page 
segment. 


authorization-list-name 
Specify the name of an authorization list. Users included on the 
authorization list are granted authority to the page segment as 
specified by the list. The authorization list must exist when the 
page segment is created. 


Text ‘description’ (TEXT) 
Specifies text that briefly describes the page segment to be created. 
The possible values are: 


*SAME 
Specifies the text used when you previously created a page 
segment of the same name. 


*BLANK 
Specifies the text is blank. 
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‘description’ 
Specify no more than 50 characters of text, enclosed in 
apostrophes. 


Replace (REPLACE) 


Specifies whether or not the page segment replaces the existing page 
segment if a page segment of the same name already exists in the library. 


The possible values are: 


*YES Anew page segment is created and the old page segment is 
replaced by it. 


*NO_ Anew page segment is not created if an old page segment of the 
same name already exists in the library. 


CVTOVLPFM (Convert Overlay to Physical File Member) Command 


This command allows you to convert an overlay (object) to a member in a physical 
database file. The overlay converted to a physical database file can be transferred 
to the VM, the MVS, and the OS/2 system. 


The following figure shows the command syntax for CVTOVLPFM command. 
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----- *LIBL/-------- 
CVTOVLPFM------ OVL------ --- *CURLIB/------ ---- over] ay-name------------- 
---]ibrary-name-- 
--*FIXED------ 
----DTAFMT------ | wn nnn nn ------------------------------------ 
-* CONTINUOUS - 
---*CURLIB/----- ---*\M-------- 
----FILE--------| wn wnne =H *MVS------- --------------------- 
-library-name- --file-name-- 
Required 
Optional 
----*0VL--------- |P| 
----MBR--- | wenn nnn nnn --------------------------------- - -- 
--member-name-- 
----*OVLTXT------ 
----TEXT-- wn enn nnn nn n------------------------------------- 
-'description'- 
----*NO -- 
----REPLACE----- sw - += -------------------------------------------- 
--*YES-- 
----«*NO -- 
----CRTFILE----- = -+ == -------------------------------------------- 
--*YES-- 
(1) ---*BLANK-------- 
----FILETEXT-- wn nnn n nnn n-------------------------------- 
-'description'- 
(1) CRTFILE='*YES' only 
| Job: B/I Pgm: B/I REXX: B/I EXEC | 


Figure 32. The Command Syntax for CVTOVLPFM Command 


The following describes the parameters for CVTOVLPFM command. 
Overlay (OVL) 


Specifies the qualified name of the overlay that is converted to a physical 
file member. This is a required parameter. 


*LIBL The library list is used to locate the overlay. 


*CURLIB 
The current library for the job is used to locate the overlay. If no 
library is specified as the current library for the job, library QGPL 
is used. 


library-name 
Specify the library where the overlay is located. 


Format of data (DTAFMT) 
Specifies how data is placed in a physical file member. 
The possible values are: 


*FIXED 
One record has one structured field. The padding character is 
binary Os. The record length of the fixed format file is the length of 
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the longest AFPDS structured field in the overlay. If the length of 
the existing file is smaller than the length of the longest structured 
field, an error message is displayed. If the length of the existing file 
is larger than the length of the longest structured field, padding 
characters are added to the end of the records. This format is for 
the VM or the MVS system. 


*CONTINUOUS 
The structured fields are filled continuously and folded. Only the 
last record has padding characters; the padding characters are 
binary Os. Any record length of the existing file is allowed. The 
created record length of the file is 256 bytes. This format is for the 
OS/2. 


This is a required parameter. 


To file (FILE) 


Specifies the qualified name of the physical file being used to fill the 
overlay data. 


The possible values are: 


*VM Specifies that the name OVLY38PP is used. It will be a valid file 
type for an overlay on the VM system. 


*MVS Specifies that the name O1xxxxxx is used. The ’xxxxxx’ is the first 
six valid characters of the name specified in the OVL parameter. It 
will be a valid member name for an overlay on the MVS system. 


file-name 
Specifies the file name to fill the overlay data. 
The library list is used to locate the overlay. 


*CURLIB 
The current library for the job is used to locate the file. If no 
library is specified as the current library for the job, library QGPL 
is used. 


library-name 
Specify the library where the file is located. 


To member (MBR) 


Specifies the name of the physical file member which is filled with the 
overlay data. 


The possible values are: 
*OVL Specifies the name of the overlay specified in the OVL parameter. 


member-name 
Specify the member name to fill the overlay data. 


Text ‘description’ (TEXT) 


Specifies text that briefly describes the member and its function. The 
description should be specified with no more than 50 characters of text and 
enclosed in apostrophes. 


The possible values are: 
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*OVLTXT 
Specifies the same description of the overlay specified in the 
overlay object. 


‘description’ 
Specify the description of the member. 


Replace (REPLACE) 


Specifies whether or not the physical file member replaces the existing 
physical file member if a physical file member of the same name already 
exists in the library. 


The possible values are: 


*NO_ Anew physical file member is not created if an old physical file 
member of the same name already exists in the library. 


*YES Anew physical file member is created and the old physical file 
member is replaced by it. 


Create file (CRTFILE) 
Specifies whether or not the file is created if the file does not exist. 
The possible values are: 
*NO _ Do not create the file. 
*YES Create the file. 
Text ‘description’ (FILETEXT) 


Specifies text that briefly describes the file and its function. This prompt is 
valid only when the CRTFILE parameter is *YES. The description should 
be specified with no more than 50 characters of text and enclosed in 
apostrophes. 


The possible values are: 


*BLANK 
No text is specified. 


‘description’ 
Specify the description of the file. 


Note: Before you use an overlay in the target system, you have to verify that the 
necessary resources to use that overlay (for example, font and page 
segment), are in the target system. Only transferring an overlay may be 
insufficient. You also have to check the version and the supported structured 
fields of the target system’s PSF*. 


An overlay which can be used on the iSeries system cannot necessarily be 
used on the target system. 


CVTPAGSPFM (Convert Page Segment to Physical File Member) 
Command 


This command allows you to convert a page segment to a member in a physical 
database file. The page segment converted to a physical database file can be 
transferred to the VM, the MVS, and the OS/2 system. 
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The following figure shows the command syntax for CVTPAGSPFM command. 


----- *LIBL/-------- 
CVTPAGSPFM----PAGSEG---- --- *CURLIB/------ ---- page-segment-name-------- 
---]ibrary-name-- 
--*FIXED------ 
----DTAFMT------ | wenn nono ------------------------------------ 
-* CONTINUOUS - 
---*CURLIB/----- ---*VM-------- 
----FILE--------| wn wnn= == *MVS------- --------------------- 
-library-name- --file-name-- 
Required 
Optional 
----*PAGSEG------ |P| 
----MBR--- enn nnn nnn nn ------------------------------- - -- 
--member-name-- 
----*PSGTXT------ 
----TEXT-- wn nnn nn nnn ------------------------------------ 
-'description'- 
----*NO -- 
----REPLACE----- sw -+ == -------------------------------------------- 
--*YES-- 
----*NO -- 
----CRTFILE----- sw -+ == -------------------------------------------- 
--*YES-- 
(1) ---*BLANK-------- 
----FILETEXT-- wee nnn nnn ------------------------------- 
-'description'- 


(1) CRTFILE='*YES' only 


Figure 33. The Command Syntax for CVTPAGSPFM Command 


The following describes the parameters for CVTPAGSPFM command. 
Page segment (PAGSEG) 


Specifies the qualified name of the page segment that is converted to a 
physical file member. This is a required parameter. 


*LIBL The library list is used to locate the page segment. 


*CURLIB 
The current library for the job is used to locate the page segment If 
no library is specified as the current library for the job, library 
OGPL is used. 


library-name 
Specify the library where the page segment is located. 


Format of data (DTAFMT) 
Specifies how data is placed in a physical file member. 


The possible values are: 
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*FIXED 
One record has one structured field. The padding character is 
binary Os. The record length of the file using fixed format is the 
length of the longest AFPDS structured fields in the page segment. 
If the length of the existing file is smaller than the length of the 
longest structured field, an error message is displayed. If the length 
of the existing file is larger than the length of the longest 
structured field, padding characters are added to the end of the 
records. This format is for the VM or the MVS system. 


*CONTINUOUS 
The structured fields are filled continuously and folded. Only the 
last record has padding characters; the padding characters are 
binary Os. Any record length of the existing file is allowed. The 
created record length of the file is 256 bytes. This format is for the 
OS/2 system. 


This is a required parameter. 
To file (FILE) 


Specifies the qualified name of the physical file being used to fill the page 
segment data. 


The possible values are: 


*VM__ Specifies that the name PSEG38PP is used. It will be a valid file 
type for a page segment on the VM system. 


*MVS Specifies that the name S1xxxxxx is used. The ’xxxxxx’ are the first 
six valid characters of the name specified in the PAGSEG 
parameter. It will be a valid member name for a page segment on 
the MVS system. 


file-name 
Specify the file to place the page segment data in. 


*CURLIB 
The current library for the job is used to locate the file. If no 
library is specified as the current library for the job, library QGPL 
is used. 


library-name 
Specify the library where the file is located. 


To member (MBR) 


Specifies the name of the physical file member which is filled with the 
page segment data. 


The possible values are: 


*PAGSEG 
Specifies the name of the page segment specified in the PAGSEG 
parameter. 


member-name 
Specify the member name to fill the page segment data. 


Text ‘description’ (TEXT) 


Specifies text that briefly describes the member and its function. The 
description should be specified with no more than 50 characters of text and 
enclosed in apostrophes. 
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The possible values are: 


*PSGTXT 
Specifies the same description of the page segment specified in the 
PAGSEG parameter. 

‘description’ 
Specify the description of the member. 


Replace (REPLACE) 


Specifies whether or not the physical file member replaces the existing 
physical file member if a physical file member of the same name already 
exists in the library. 


The possible values are: 


*NO_ Anew physical file member is not created if an old physical file 
member of the same name already exists in the library. 


*YES Anew physical file member is created and the old physical file 
member is replaced by it. 


Create file (CRTFILE) 
Specifies whether or not the file is created if the file does not exist. 
The possible values are: 
*NO Do not create the file. 
*YES Create the file. 
Text ‘description’ (FILETEXT) 


Specifies text that briefly describes the file and its function. This prompt is 
valid only when CRTFILE parameter is *YES. The description should be 
specified with no more than 50 characters of text and enclosed in 
apostrophes. 


The possible values are: 


*BLANK 
No text is specified. 


‘description’ 
Specify the description of the file. 


Note: You must check the version and the supported structured fields of the target 
system’s PSF. 


A page segment which can be used on the iSeries cannot necessarily be used 
on the target system. 
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Chapter 22. Limitations and Restrictions 


This chapter describes the limitations and the restrictions that you need to know to 
use the AFP Utilities for iSeries. 


Overlay Utility 


Limitations 


Minimum and Maximum Limitations 


Table 81. Overlay Utility minimum and maximum limitations 


Item Minimum limitation Maximum limitation 
Number of elements ina source 0 999 

overlay. 

Width of overlay 0.1 inches 22.75 inches 

Height of overlay 0.1 inches 22.75 inches 

Number of page segments in a 0 999 


source overlay 
Each printer has its own 


limitations. Most printers 
allow 127 page segments 
maximum. The storage size 
of the printer may also 
limit the number. 

Number of graphics ina source 0 999 


overlay 
The storage size of the 


printer may limit the 


number. 
Length of text 1 (may be blank) 203 
number of text lines in a box 0 (no text) 51 


element 


Dashed and Dotted Lines 
If the length of a line is too small compared with the line width, dashed and 


dotted lines are printed as solid lines. 


The minimum length of this limitation depends on the line width. 


Line Width and Overlay Size 

If a line or a box is near the edge of the overlay and the line width is too big, some 
portion of the line may exceed the overlay size although the line or the box 
element is inside. 


In this case, no lines are printed for that element and an error message is 
displayed. 


Element Position 

If you specify the overlay size in inches or centimeters and specify an element 
position in inches or centimeters, you may not be allowed to specify the position, 
although the position is inside the overlay size. This can occur at positions near the 
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right edge or bottom of the overlay. The position, specified in inches or 
centimeters, must be inside the overlay when it is expressed in rows and columns. 
For example: 


Characters per line .........-.e00. 10 
Lines per inches ..........eseeeee 6 
OVERT AY WIGEN seccccenccsisrnstuaredveensessanccears 5.15 inches 
(51 columns) 
HO TQNE:  aisieisel eats sees eareae 6 6.1 inches 
(36 lines) 
POSITION: AGKOSS: wicca siesreseewieenereawre 5.12 inches is not allowed since 
it will be in the 52nd column. 
DOWIE 6:4; ievesiscel a) aveidtieraienavecoens 6.05 inches is not allowed since 


it will be in the 37th line. 


When you use a 300-pel printer to print a text element whose character size is not 
*DEFAULT, it may not print when the position of the text element is too close to 
the bottom of the overlay. In such cases, the text element should be moved to an 
upper location or the height of the overlay size should be increased. 


Restrictions 


Source Overlay File 
If a file meets the following four conditions, it is shown on the Work with Source 


Overlay Files display as a source overlay file even if it is not created as a source 
overlay file. 

* The file is a physical file 

* The file is not a source file 

* The file is not a DDM file 

* The record length is 80 


It is recommended that you use files created using the overlay utility. 


Font 


1. It is not checked if the specified font exists. If the font does not exist, errors are 
issued when your printout with the overlay is sent to the printer. 


2. It is not checked if the specified font is an SBCS font or a DBCS font. If you 
specify a DBCS font for SBCS characters or specify an SBCS font for DBCS 
characters, the result depends on the text to be printed. The text may be 
printed with unexpected characters, or not printed with some errors. 


3. On the Work with Source Overlay Fonts display you can select *DEFAULT to 
specify the default font value of the text element, the box element, or the 
graphics element. When you print an overlay using *DEFAULT without any 
changes, the Courier 10 font (FONT ID 11) is sent to the printer. When you use 
a type 1 printer (IBM 4224/4234/4230) under the printer mode which doesn’t 
have Courier 10, (such as the draft mode of the 4224 printer), you can not print 
with *ABSOLUTE for the print fidelity. In such cases, select *CONTENT for the 
print fidelity. 


Page Segment 

1. The program does not verify if the specified page segment exists. If the page 
segment does not exist in a library in the library list of the job, errors are issued 
when your printout is sent to the printer. 

2. When a printout with an overlay is sent to the printer, the libraries in the 
library list of the job that created the printout are searched to locate the 
specified page segment. 
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You need to do the following before you create a printout with the overlay: 

* Put the correct page segment in a library. 

* Put the library in the library list. 

* Make sure the library that contains the desired page segment appears in the 
library list before any other library containing a page segment of the same 
name. 

3. It is unpredictable which font will be used if a page segment contains text. The 
font used to print the text can not be specified. Depending on the situation, a 
font specified for text within a page segment may be used, or the printer 
default font may be used. 


4. It is not checked if a page segment contains either or both IM1 and IO1 format 
images. IM1 images may not be printed in the desired resolution on some 
printers, and IO1 images cannot be printed on some printers. When IOCA 
images are used, support only IOCA function set 10. 


A for restrictions of each 
printer. 

5. When 90, 180, or 270 is specified in the Degree of rotation prompt on the Define 
Overlay Specifications screen, page segments defined in the source overlay do 
not rotate with the overlay. 


Line 
Nothing is printed for lines that have a greater width than length. 


Box 
Nothing is printed for boxes that have line width specified which is greater than 
either the box width or the box height. 


Text in Box 
Text in a box is formatted by using the character spacing parameter specified on 
the box element. If the font size is different, formatting is incorrect. 


For example: 


Character spacing : 
HOVIZONCA] once cdvcdases soaaeaewe 10 
VERT CA kc cance awsaa ee adauis wo 6 


WHOEM, cisiacee.dcsrecdcaususiarcuslavee's a a)atealale sis 0.2 inches ( 5 CPI ) 
NEVONE Wo wtedsaasew decid dacdawens 0.33 inches ( 3 CPI ) 


Text will be printed to the right of the correct position for center. The second and 
subsequent lines will partly duplicate the preceding lines. 


To avoid this situation, specify the character spacing value equal to that of the font. 


Shading in Box 
It sometimes takes a long time to print shaded boxes (especially with the IBM 4028 


printer). 


Graphics (GDF) Size 

AFP Utilities for iSeries has no limitations and restrictions for the graphics (GDF) 
size, but printing an overlay which contains some large graphics (GDF) or too 
many graphics may cause a printer storage excess error. In such cases, check the 
printer storage size. 
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Text Font in Graphics (GDF) 
When a graphics element contains text characters, the text is printed using the font 
which is specified for the graphics element. 


Overlay object authority 
When you replace an existing overlay by creating an overlay, the Authority 
parameter is ignored and the authority of the existing overlay remains. 


Printer Dependencies 
Each printer has some unique restrictions. For example, some printers do not allow 
the data stream to print text vertically. 


See Zi for restrictions of each 


printer. 


Print Format Utility 


Limitations 


Minimum and Maximum Limitations 


Table 82. Print Format Utility minimum and maximum limitations 


Item Minimum limitation Maximum limitation 
Number of elements ina PFD 0 999 for a record layout and 
definition. 999 for a page layout. 


Therefore, the total for a 
PFD definition is 1998. 


Width of page 0.1 inches 22.75 inches 

Height of page 0.1 inches 22.75 inches 

Number of page segments ina 0 999 for both 

record layout and a page 

layout. Each printer has its own 


limitations. Most printers 
allow 127 page segments 
maximum. The storage size 
of the printer may also limit 
the number. 


Number of repeated record 0 999 
layout in the page layout 

Number of graphics ina PFD 0 999 
definition. 


The storage size of the 
printer may limit the 


number. 
Length of text 1 (may be blank) 203 
number of text lines in a box 0 (no text) 51 
element 
Number of mapping object 0 99 


names for one object type. 


Dashed and Dotted Lines 
If the length of a line is too small as compared with the line width, dashed and 
dotted lines are printed as solid lines. 


The minimum length of this limitation depends on the line width. 
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Line Width and Page Size 

If a line or a box is near the edge of the page and the line width is too big, some 
portion of the line may exceed the page size although the line or box element is 
inside. 


In this case, no lines are printed for that element and an error message is 
displayed. 


Element Position 

If you specify the page size in inches or centimeters and specify an element 
position in inches or centimeters, you may not be allowed to specify the position, 
although the position is inside the page size. 


This can occur at positions near the right edge or bottom of the page. The position, 
specified in inches or centimeters, must be inside the page when it is expressed in 
rows and columns. For example: 


Characters per line .........-.000- 10 
Lines per inches ..........eseeeee 6 
PAGO AWA CEM, sxiiordnevtareonanedeoe vecsiantesi arenene siane 5.15 inches 
(51 columns) 
NEIGH wisocscsaccswesewsan saws 6.1 inches 
(36 lines) 
POSItION ACVOSS. wscccececnceseseves 5.12 inches is not allowed since 
it will be 52nd column. 
DOWN: seccdewctiee causes wears 6.05 inches is not allowed since 


it will be 37th line. 


When you use a 300-pel printer to print a text element whose character size is not 
*DEFAULT, it may not print when the position of the text element is too close to 
the bottom of the page. In such cases, the text element should be moved higher in 
the page or the height of the page size should be increased. 


Restrictions 
PFD Definition File 


If a file meets the following four conditions, it is shown on the Work with PFD 
Definition Files display as a PFD definition file even if it is not created as a PFD 
definition file. 

* The file is a physical file 

* The file is not a source file 

* The file is not a DDM file 

* The record length is 80 


It is recommended that you use files created using the Print Format Utility. 


Font 

1. It is not checked if the specified font exists. If the font does not exist, errors are 
issued when your printout is sent to the printer. 

2. It is not checked if the specified font is an SBCS font or a DBCS font. If you 
specify a DBCS font for SBCS characters or specify an SBCS font for DBCS 
characters, the result depends on the text to be printed. The text may be 
printed with unexpected characters, or not printed with some errors. 

3. On the Work with PFD Definition Fonts display you can select *DEFAULT to 
specify the default font value of the text element, the box element, or the 
graphics element. When you print a page using *DEFAULT without any 
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changes, the Courier 10 font (FONT ID 11) is sent to the printer. When you use 
the type 1 printer (IBM 4224/4234/4230) under the printer mode which does 
not have Courier 10, (such as the draft mode of the 4224 printer), you can not 
print a page with *ABSOLUTE for the print fidelity. In such cases, select 
*CONTENT for the print fidelity. 


Page Segment 

1. It is not checked if the specified page segment exists. If the page segment does 
not exist in a library in the library list of the job, errors are issued when your 
printout is sent to the printer. 


2. When a database file printout is sent to the printer, the libraries in the library 
list of the job that created the printout are searched to locate the specified page 
segment. 


You need to do the following before you print a database file member with a 
PFD definition: 


* Put the correct page segment in a library. 
* Put the library in the library list. 


* Make sure the library that contains the page segment appears in the library 
list before any other library containing a page segment of the same name. 


3. It is unpredictable which font will be used if a page segment contains text. The 
font used to print the text can not be specified. Depending on the situation, a 
font specified for text within a page segment may be used, or the printer 
default font may be used. 


4. The program does not verify if a page segment contains either or both IM1 and 
IO1 format images. IM1 images may not be printed in desired resolution on 
some printers, and IO1 images cannot be printed on some printers. When 
IOCA images are used, support only IOCA function set 10. 


on page 417] for restrictions of each 
printer. 

5. When 90, 180, or 270 is specified in the Degree of rotation prompt on the Define 
PFD Specifications screen, the page segments defined in the PFD definition do 
not rotate with the page layout. 


Line 
Nothing is printed for lines which have a greater width than length. 


Box 
Nothing is printed for boxes which have a line width specified which is greater 
than either the box width or the box height. 


Text in Box 
Text in a box is formatted by using the character spacing parameter specified on 
the box element. If the font size is different, formatting is incorrect. 


For example: 
Character spacing : 


HOV A ZONAL scars secaracees aeons caiewnns 10 
VEPEI Cal sissies. ose cae caaeaduesadwes 6 
Font for text in a box 
WIEN staid arcitate naitieeee de ene ewe ee 0.2 inches ( 5 CPI ) 
HEIGht. sscsccxsesncsdexderwedaeders 0.33 inches ( 3 CPI ) 


Text will be printed to the right of the correct position for center. The second and 
subsequent lines will partly duplicate the preceding lines. 


396 AFP Utilities for iSeries: User’s Guide 


To avoid this situation, specify the character spacing value equal to that of the font. 


Shading in Box 
It sometimes takes a long time to print shaded boxes (especially with the IBM 4028 
printer). 


Graphics (GDF) Size 

AFP Utilities for iSeries has no limitations and restrictions for the graphics (GDF) 
size, but printing a page which contains some large graphics (GDF) or too many 
graphics may cause a printer storage excess error. In such cases, check the printer 
storage size. 


Text Font in Graphics (GDF) 

When a graphics element contains text characters, the text is printed using the font 
which is specified for the graphics element. 

Each printer has some unique restrictions. For example, some printers do not allow 
the data stream to print text vertically. 


page 417] for restrictions of each 


Resource Management Utility 


Limitations 
None. 


Restrictions 


IMDS (IOCA) Data Stream 

Input IMDS (IOCA) data must be correct. Only IOCA function set 10 is supported. 
Some parameters are checked, but some are not checked. If input IMDS data is not 
correct, the result is unpredictable. It may be printed with some errors, or may not 
be printed. 


The bytes 3-6 (logical units per unit base) field in the Image Size Parameter Image 
Order, which appears in the Image Picture Data structured field, must not be 0. 


Print Operation 
The content of an overlay and a page segment is not checked for whether or not it 
can be printed on the destination printer. 


A for the detail of the 


Creating Page Segment 
When you replace the existing by creating a page segment, the Authority parameter 
is ignored and the current authority remains. 


Converting an Overlay to a Physical File Member 


Note: Before you use an overlay in the target system, you should verify that the 
necessary resources to use that overlay, for example, font, page segment, are 
on the target system. Only transferring an overlay may be insufficient. You 
also should check the version and the supported structured fields of the 
target system’s PSF. 
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An overlay which can be used on the iSeries cannot necessarily be used on the 
target system. 


Converting the Page Segment to a Physical File Member 


Note: You should check the version and the supported structured fields of the 
target system’s PSF. 


A page segment which can be used on the iSeries cannot necessarily be used on 
the target system. 


Sending Source Overlays and PFD Definitions 


When you transfer a source overlay or a PFD definition to another iSeries system, 
you should not send it directly with the SNDNETF command. Instead, you should 
send it as a saved file as follows. Otherwise, it will not be recognized as a source 
overlay or a PFD definition on the destination iSeries system. 


On the source iSeries system: 
1. Create a save file. 
CRTSAVF SRCOVLSAVF 
2. Save a source overlay file or a PFD definition file. 
SAVOBJ OBJ(SRCOVLFILE) LIB(OVLLIB) DEV(*SAVF) SAVF(SRCOVLSAVF) 
3. Send the saved file. 
SNDNETF SRCOVLFILE TOUSRID( (USER NEWSYS)) 


On the target iSeries system: 
1. Create a save file. 
CRTSAVF SRCOVLSAVF 
2. Issue WRKNETF command. 
WRKNETF 
3. Receive the file into the newly created save file with option 1. 
4. Restore the save file: 
RSTOBJ OBJ(*ALL) SAVLIB(OVLLIB) DEV(*SAVF) SAVF(SRCOVLSAVF) 


Note: All source overlays or PFD definitions in the file are sent together. 
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Chapter 23. Problem Analysis 


If a problem occurs while you are using the IBM Advanced Function Printing 
Utilities for iSeries or its output is being printed, the cause of the problem may not 
be obvious. An error in your application, in the system environment, or the IBM 
Advanced Function Printing Utilities for iSeries are all possible causes of an error 
condition. The problem analysis procedure in this chapter can help you isolate the 
cause of the problem and solve it. If you need more information, refer to 


This procedure is arranged as a sequence of questions to which you can answer Yes 
or No. Depending on your answer, you are either directed to another question or to 
a recommendation for action. The number in the box shows the sequence number 
of the step. 


on page 404 are also provided to ‘help you oe the cause 
aay You may be directed to one of these lists by the following procedure. 


Start at Question 1 and follow the question-and-answer sequence, answering each 
question to which you are directed. If the problem is a condition that requires 
more detailed procedures, you are referred to those procedures. 


Identifying Problems 


When a problem occurs, follow the procedures below to pinpoint its possible 
cause: 


0100: Problem Analysis Procedures 


001: Did the problem occur after a spooled file had been created? 
This question asks if programs of IBM Advanced Function Printing 
Utilities for iSeries have completed and you have problems with the 
spooled file; for example, you cannot print the spooled file or the printout 
is not as expected. 


Yes Go to Step 002. 
No Go to Step 006. 


002: Was your printout different from what you expected? 
If you do not receive anything although you expect a printout, your 
answer is “Yes’. 


follow the directions. 
No Go to Step 005 on page 
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003: Do you still have the problem? 
Yes Go to Step 004. 
No The problem was resolved. 


004: Does the printer have the current PTF level? 
See the manual for your printer to verify the PTF level. 


Yes Go to Step 005 below. 
No Do the following: 
1. Install the current level of PTF. 
2. Retry the IBM Advanced Function Printing Utilities for iSeries 


function. 


005: Were there any messages in the print writer's message queue indicating an 
error condition that prevented the print writer job from completing the job? 


on _page 404 and follow the 


directions. 
No Go to Step 012 on page kool 
006: Do you still have the problem? 
Yes Go to Step 012 on page Loo 


No The problem was resolved. 


007: Did you receive a message indicating an error condition that prevented you 
from completing the task? 


Yes Take the actions indicated by the messa 


you to call for help, see 


When you examine a message to see what actions are required, 
check the following: 


* Second-level message text, which describes the message in more 
detail. To display the second-level message text, position the 
cursor on the message line and press the F1 (Help) key. 


* Cause and Recovery, if applicable, for an explanation of the 
possible cause of the problem and for appropriate recovery 
actions. 


You may be receiving more than one message. A plus sign (+) at 
the end of the message indicates there are more messages being 
sent. To see the remaining messages, position the cursor on the 
message line and press the Roll Up (Page Down) key. 


message, see 


No Go to Step 008 on page kool 
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008: Has the input inhibited light stayed on longer than expected? 
Yes 


Press the Error/Reset key. If the light does not go off, do one of the 

following: 

* Press the System Request key and press the Enter key. When the 
system request menu appears, start an alternate job. 


* Go to another work station and sign on. 


Enter the Work with Subsystem (WRKSBS) command to request 
the Work with Subsystems display. Choose the Work with 
subsystems jobsoption for the subsystem you are running under. 
Look for a job entry that has the same job name as the work 
station with the problem. If two entries are shown, look at both. 
Write down the names. 


No Go to Step 010 on page kool 

009: Does the job entry (or entries) indicate a status of HELD? 
Yes Enter 6 in the input prompt next to the job name to release the job. 
No 


You could have a loop or wait state. Do the following to gather 
helpful information. 


Type the Work Job (WRKJOB) command and press the F4 (Prompt) 
key. Choose the following values for the command parameters: 


Parameter Value 


Job name 
Job name, user name, and job number for the failing job. 


Output 
*PRINT to print the job information for later use. 


1. When the Work with Job menu appears, select option 
11 (Display the program stack). Press the Print key to 
print the program stack for the failing job. 

The program stack lists the instruction the program is 
currently on. This may help you determine why the 
loop or delay occurred. 

2. Press the F3 (Exit) key until you return to the 
Command Entry display. 

3. Type the End Job (ENDJOB) command to cancel the 
failing job. For example: 

ENDJOB JOB(008298/QUSER/DSPO1) 


Check with the system operator to ensure that the job 
log for the failing job is printed. The job log is a record 
of each program action and any messages resulting 
from these program actions. 


Note: Your job log should be printed if you use the 


default value for the log limit (LOGLMT) 
parameter on the ENDJOB command. If the job 
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description specifies a 0 for the message level in 
the LOG parameter, a job log is not printed. 
4. Examine the job log to find out why the problem 
occurred. 


If you cannot solve the problem, see Contacting Youd 


010: Did you send a source overlay or PFD definition to another iSeries and you 
can not use it on the destination iSeries system? 


No Go to Step 011 below. 


011: Is the current version and release of the IBM Advanced Function Printing 
Utilities for iSeries on your system? 

To verify the version and release number of your system, type 

GO LICPGM 


Select ‘Display installed licensed programs’ on the menu, and look at the 
installed release of 5716-SS1 on the list. 


To verify the version and release number of the IBM Advanced Function 
Printing Utilities for iSeries, look at the installed release of 5716—AF1 on 
the list. 


The IBM Advanced Function Printing Utilities for iSeries must have the 
same version and release number as the IBM iSeries operating system. 


Yes Go to Step 012 below. 


No Do the following: 


1. Install the current version and release level of IBM Advanced 
Function Printing Utilities for iSeries. 


2. Install all current program changes to IBM Advanced Function 
Printing Utilities for iSeries. 


3. Retry the IBM Advanced Function Printing Utilities for iSeries 
function. 


See the Software Installation manual for a description of how to 
install IBM Advanced Function Printing Utilities for iSeries and 
make program changes. 


012: Have all IBM-supplied program changes that you received for the current 
release of IBM Advanced Function Printing Utilities for iSeries been installed? 


Yes Do the following if you require additional assistance: 


* Cancel the failing job and print the job log. Sign off the work 
station, choosing *LIST for the LOG parameter. For example 


SIGNOFF LOG(*LIST) 


Call the system operator to verify that the job log was printed. 
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* Follow the directions in 


Install the program changes that have not yet been applied and try 
the IBM Advanced Function Printing Utilities for iSeries function 
again. See the Software Installation manual for a description of how 
to install program changes. 


Common Symptoms and Possible Causes 


The following shows common problems and their possible causes. 


Your problem may match more than one item in the table. For example, if you 
print a page segment and it is not printed; you may need to check both "Nothing 
is printed" and "Image (page segment) is not printed”. 


Your specified font type may be changed by the system. In that case, a message is 
sent to the message queue of the printer writer that indicates font substitution. 


Table 83. Common symptoms and possible causes 


Symptom Possible Causes 


Nothing is printed a 


Page number is not A 
printed 


The printer writer is not started. 


There are many spooled files in the output queue. (This is not an 
error. You should wait for your turn, or increase the priority of 
your spooled file.) 


The printer is not an IPDS printer. 
The printer is not configured for Advanced Function Printing. 


The output queue that contains your spooled file is not associated 
with an active printer writer. 


The printer writer is waiting for a message reply. 


You specified *ABSOLUTE for print fidelity and some errors 
occurred. See the message queue of the printer writer or specify 
*CONTENT for print fidelity. 


The overlay size or page size exceeds the printable area. See the 
manual of your printer for the size of the printable area. If the 
offset values of the form definition are not zero, you must add the 
values to check. The form definition name is specified in the 
device description of the printer. See Printer Device Programming 
for the offset values of the form definition. 

You specified a font of font type 1 (specified with a font and 
character identifier) or did not specify any font although the 
printer supports only font type 2 (specified with a coded font) and 
font type 3 (specified with a code page and a font character set). 
You specified a font of font type 2 (specified with a coded font) or 
font type 3 (specified with a code page and a font character set) 
although the printer supports only font type 1 (specified with a 
font and character identifier) 

The print data exceeds the size of printer storage. 

You specified a page size that is larger than the paper. 

The page number is printed at the center of the last line of the 
page. 
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Table 83. Common symptoms and possible causes (continued) 


Symptom 


Possible Causes 


Bar code is not 
printed 


Image (page 
segment) is not 
printed 


Graphics is not 
printed 


One or more 
elements are not 
printed 
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The printer does not support the specified type of bar code. 

The printer does not support the degree of rotation for bar code. 
(If you rotate the overlay or page, the degrees of rotation must be 
specified for the bar code.) 

If the bar code is printing a field in a database, the value or length 
of the field is not correct for the bar code type. 

The image is not in a library in the library list when the spooled 
file is created. 

The image was deleted before the spooled file was printed. 

The printer does not support IO1 image, but the image was an 
IO1 image. 

Note: I01 and IOCA Function Set 10 are synonymous. 

You specified rotation and the image went outside of the page. 
The number of page segments exceeds the printer’s allowable 
maximum. Most printers allow a maximum of 127 page segments 
in a page. 

The page segment has no image in it. 

A field in a database file is used in a page segment but the value 
or the length of the field is not correct. 

The printer does not support graphics. 

The printer does not support the degree of rotation for graphics. 
(If you rotate the overlay or page, the degree of rotation must be 
specified for the graphic.) 

If a field in a database file contains a graphic object name, and the 
value or the length of the field is not correct. 

You specified *ABSOLUTE for the print fidelity for a printer which 
does not support colors other than black. Graphics (GDF) has a 


color that is not supported by such a printer in general. Specify 
*CONTENT for print fidelity. 


The element has been removed. 


° The specified font is not available. 


You specified a font incorrectly; for example, you specified a SBCS 
font for DBCS text. 

The line width is 0. 

The record layout has no element. 

You specified a font of font type 1 (specified with a font and 
character identifier) or did not specify any font although the 
printer supports only font type 2 (specified with a coded font) and 
font type 3 (specified with a code page and a font character set). 
You specified a font of font type 2 (specified with a coded font) 
and font type 3 (specified with a code page and a font character 
set) although the printer supports only font type 1 (specified with 
a font and character identifier) 


You specified a color that is not supported by the printer. 


Table 83. Common symptoms and possible causes (continued) 


Symptom 


Possible Causes 


Different image (page « The image is not in a library in the library list when the spooled 


segment) is printed 


Text lines overlap 


Text in a box is not 
formatted correctly 


Font is not as 
expected 


Character size is not 
as expected 


Element position is 
not as expected 


Text is not as 
expected 


Text in graphics is 
not as expected 

The length of the 
dotted or the dashed 
line is not correct 


file is created or another image resides in a library that is higher 
in the library list. 

The image is changed before the spooled file is printed. 

The image is an IM1 image and the density (usually 240 pels per 
inch) is different from that of the printer. 

You specified a different mapping option when you created the 
page segment. 

The height of the font is not the same as the value specified for 
the lines per inch on the Overlay Specifications display or the PFD 
Specifications display. 

The font size is not the same as the value specified for the 
character spacing on the box element. 

The specified font does not exist and it was substituted by another 
font. 

If the printer is different, the printout may somewhat vary 
although the same font is specified. 


You specified different values for width and height of the 
character size, but some printers do not support different values 
and the smaller value is used for both width and height. 


The printer does not support changing the character size. 


The text uses a font of font type 2 (specified with a coded font) or 
font type 3 (specified with a code page and a font character set) 
although you cannot change the character size for these types of 
fonts. 


The font has more spaces around the characters than you 
expected. (The width and height specifies the font size including 
spaces around characters.) 


You might have misunderstood the_element position. The position 


depends on the element type. See 
Gage and for detail. 


The value of the Unit of measure is different. 


You changed the measurement method. This may cause the 
element to move within the same row/column position even 
though you change the measurement method again. 


The field you specified for the text does not exist in the file. 

You specified rotation, but the printer does not support it. (If you 
rotate the overlay or page, the degrees of rotation must be 
specified for the text element.) 

You specified the vertical format, but the printer does not support 
it. 

You specified a color that is not supported by the printer. 


You specified a value too small for the Character size prompt on 

the Define Text Detail display or the Change Text Detail display 
and your printer is the 4224 printer, the 4234 printer, or the 4230 
printer. 


The size you specified for the graphics element is small and your 
printer is the 4224 printer, the 4234 printer, or the 4230 printer. 


You specified a different printer type in the overlay specifications 
or the PFD specifications. 
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Table 83. Common symptoms and possible causes (continued) 


Symptom 


Possible Causes 


Shading in the box 
element is not correct 


or the PFD specifications. 


* You specified a different printer type in the overlay specifications 


Sense Codes and Possible Causes 


Some messages sent to the message queue of the printer writer show the sense 
data returned by the printer. To see the sense data, position the cursor to the 
message and press the F1 (Help) key. The second-level message appears, and its 
cause shows the sense data if applicable. For example, 


the corresponding sense data is X'Q118'..X'02' X'O1'. Processing of the 


01, 18, and 02 is the sense byte 0, 1, and 19. 


The following table shows typical sense bytes and their possible causes: 


Table 84. Sense bytes and possible causes 


Sense Bytes 0, 
1, 19 


Description and Possible Causes 


Recovery 


0218..02 


0300..01 


0300..0E 


03C3..00 


0403..00 


Invalid font ID: 


You specified the vertical format of 
text although its font is font type 1 
(specified with a font and character 
identifier) 

Unallocated or unsupported 
graphics command code: 


You specified both of the following 

for the text although your printer 

supports only black. 

¢ Avalue other than *DEFAULT 
and 8=Black for the Color prompt. 

¢ A-value other than *DEFAULT for 
the Character size prompt. 

Unsupported attribute value 


An attribute value for a graphics 
order of your GDF is not supported 
by your printer. 

Character symbol set not available: 


You specified the vertical format of 
the text with Character size value 
other than *DEFAULT though its 
font is font type 1 (specified with a 
font and character identifier) 
Unsupported bar code type: 


You specified a bar code type that is 
not supported by the printer. 


Specify the horizontal format or use 
a font of font type 2 (specified with 
a coded font) or font type 3 
(specified with a code page and a 
font character set). 


Specify *DEFAULT for the Color 
prompt. 


Specify *CONTENT for print 
fidelity or use the standard default 
value for the attribute. 


Specify the horizontal format or use 
a font of font type 2 (specified with 
a coded font) or font type 3 
(specified with a code page and a 
font character set). 


Change the bar code type or the 
printer. 
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Table 84. Sense bytes and possible causes (continued) 
Sense Bytes 0, __ Description and Possible Causes Recovery 
1, 19 


0405..00 Unsupported bar code color: Specify *DEFAULT for the Color 
prompt. 
You specified a value other than 
*DEFAULT or 8=Black for the Color 
prompt of the bar code although 
your printer supports only black 
color. 
0406..00 Unsupported unit/module width: Change the module width or the 


printer. 
You specified a module width value 


of a bar code that is not supported 
by the printer. 
0821..00 Undefined character: Use correct data and correct font. 


One or more characters in the text 
have a code point that is not 
defined. 


¢ An attempt to print a record in 
the database file member with 
one or more characters whose 
code points are not defined is 
made. 

¢ A record in the database file 
member contains characters not 
supported by the bar code type 
specified for a bar code. 

* The font specified to print text is 
not correct. For example, a DBCS 
font is specified for SBCS text. 

08C1..00 Position check: Reduce the overlay size. 


Overlay size is too large. 


Contacting Your Service Representative 


If you cannot solve a problem using the problem analysis procedure listed in this 
appendix, you may want to contact your service representative. Before contacting 
your service representative, be prepared to provide the following information: 


* A copy of the display on which the problem occurred and the values specified. 


If a copy is not obtained because you cannot press the Print key, provide the title 
of the display, all values you specified, and the key you pressed. 


* A copy of the source overlay or PFD definition being processed (if applicable). 
* Acopy of the input database file (if applicable). 


If the problem occurred while your spooled file was being printed, the following is 
also required: 


* Acopy of the page segment being used. 

* Acopy of the spooled file being printed. 

* Acopy of the job log of the printer writer. 
* Acopy of the printout. 
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Element Type and Position 


The positions of the elements have subtle differences depending on the element 
type. 


Text Element and Position 


Measurement Method is Row/Column 

The left edge of the character is positioned to the left edge of the column. The 
bottom of the character is positioned one fifth of the character height above the 
bottom of the row. 


| Column n | 


Row n_ |character 
box 


Measurement Method is Inch or Centimeter 
The left edge of the character is positioned to the horizontal position. The bottom 
of the character is positioned to the vertical position. 


+--------- + 
character 
box 
+--->+--------- + 
Position 
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Line Element and Position 


Measurement Method is Row/Column 
Line Placement is Border: The top of a horizontal line is positioned to the top of 
the row. The left side of a vertical line is positioned to the left of the column. 


Start End 
Column Column 
el a sh al PS a ae ae a. = Nami Sia, eS: ce, mm ne fk a ro ae, a, ee ce 
| Horizontal Line | 
Kew ewe eee eee ew ewe ew wee ee = ee ee et eee ee eee ee ee ee ee ee * 
Row n | | 
| | | 
| | | 
e------- +-----------+------- - - = - = = 22 eee tee te 
| | | | 
Column n 
------- +---+-------+------- 
| | | 
Start | V | | 
Row e 
r 
t 
j 
| c | | 
=ceSSee= * Q ke----- tee 
£1 : 
ees AG eee ae eee 
i | | 
End n 
Row e 
| | | 
-------- +---+-------+------- 
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Line Placement is Center: The center of a horizontal line or the top of a vertical 
line is positioned to the center of the column or row. The center of a vertical line or 
the left edge of a horizontal line is positioned to the center of the column. 


| Start | | End | 
| Column | | Column | 
woo te---- eee ete eee nee ee nee enn tenn ne tee 
Row n te------------ - = 2 eee nnn n-------- + 
| Horizontal Line | 
bese ee eos ose, ta. fee ee et 18; Seen e Suet ee + | 
-------- t---------- teen ee ee nee enn ten eee tee 
| | | 
| | | 
| 
Column n | 
------- +-----------+------- 
Start 
Row | 
os | 
| v | 


| | | | 
eoo---- t---+ ] +---+------- 
j 
End n 
Row le | | 
pose} | 
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Measurement Method is Inch or Centimeter 
The top edge of a horizontal line is positioned to the vertical position. The left 
edge of a vertical line is positioned to the horizontal position. 


Position ‘tm 

V | V 
+--->+----------------- + +--->+-+ 
| Horizontal | |v | 
+----------------- + e 

r 
| 

j 

C 

a 

] 

+- 


Box Element and Position 


Measurement Method is Row/Column 

Line Placement is Border: The top edge of the top horizontal line is positioned to 

the top of the row. The bottom edge of the bottom horizontal line is positioned to 

the bottom of the row. The left edge of the left vertical line is positioned to the left 
of the column. The right edge of the right vertical line is positioned to the right of 


the column. 
| Start | | End | 
| Column | | Column | 
go in ke ina a a a a pa pve « gag ke — ay Sa “spc ply Gh ae a a oy a a a a a ca Sa 
Border box | 
Start $eteeceseseseese e S00 ae S Seetie esececes + | 
“ | | | | | 
-------- t +-------+------- - - = = = = -e een te- Ht +------- 
| | | | | | 
| | | | | | 
------- + +-------+------- - - = = = = 22-2 ---t--- === t +------- 
| | | 
End 
Row 
+--------------- - - = = = = 25-2 - == + 
a a Be ee te ee ee ee ee ee ee et ee es ee 


Chapter 23. Problem Analysis 411 


Line Placement is Center: The center of horizontal lines is positioned to the center 
of the row. The center of vertical lines is positioned to the center of the column. 


| Start | | End | 
| Column | | Column | 
------- t-----------t------- = ee 8 nen enn ete ne ee ete 
Start 
Row J ten nn nnn nnnnnnne = 2 = ee ween eee ------- + | 
Center box 
t----------- - - = = = = fener t 
-------- t---+ t---t------- - - = = = = 22-2 ---t---t +---+------- 
| | | | | | 
1 || | | | 
| | | | | | 
Ie idl sd | | | 
------- +---+ te--t------- - - = = = = 22-2 ---t---t +---+------- 
oe | | | | | 
End | | | | | | 
Row tennnnnnnnne 2 ee ee wenn eee ---t 
3 | 
+--------------- - - - = = = enn + 
-------- t-----------t------- = ee 8 8 nen en nn ten nn eee ee te 


Measurement Method is Inch or Centimeter: The top of the horizontal lines is 
positioned to the vertical position. The left of the vertical lines is positioned to the 
horizontal position. 


Position 
| 
| Vv 
+-->+------------------------- --- - - = - = So 
| | 
+----------------------------------- + 
| | | 
| | | 
+ + + + 
| | | 
+ + + + 
| ee ee ee eee + --|<--+ 
| | 
| | | 
+----------------------------------------- = oe 
| 
+------- Position 
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Bar Code Element and Position 


Note: Bar code elements have some leading blanks before the bars. Thus the first 
bar does not start at the specified position. 


Measurement Method is Row/Column 
Top of the row and left edge of the column is the bar code position. 


Column n 


Measurement Method is Inch or Centimeter 
Top left corner of the bar code area is positioned. 


Position 
| 
V 
+--->+--------------------- - - --- + 
|| al I | 
+--------------------- - - --- + 
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Page Segment Element and Position 


Measurement Method is Row/Column 
Top of the row and left edge of the column is the page segment position. 


| Column n | 
wooo +------------ eee ee eet 


Page segment 
Row n 


Measurement Method is Inch or Centimeter 
Top left corner of the page segment is positioned. 


Position 
V 
+--->+--------------------- - - --- + 


Record Layout Element and Position 


Measurement Method is Row/Column 
Top of the row and left edge of the column is the record layout position. 


Column n 
------- +--------------------- - - ---+ 


Record layout | 


+ 
| 
| 
+ 
| 
| 


Measurement Method is Inch or Centimeter 
Top left corner of the record layout is positioned. 


Position 
V 
+--->+--------------------- - - --- + 
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Graphics Element and Position 


Measurement Method is Row/Column 

The top side of the graphics block is positioned to the top of the row. The bottom 
side of the graphics block is positioned to the bottom of the row. The left of the 
graphics block is positioned to the left of the column. The right of the graphics 
block is positioned to the right of the column. 


Start End 
Column Column 
wa i inc wie a a i si, cr is dee a ie ee a a ae a a a es ee 
| | 
Start | | 
Row | 
| | 
a + De 
| 
i i a ah + Se 
| | 
End | | 
Row | 
| | 
cis i i ih I a a cn a i a a nl ae a So es he i i os mn Se sp Pc ‘ol 
| 
| 


Measurement Method is Inch or Centimeter 
The horizontal side of the graphics block is positioned to the vertical position. The 
vertical side of the graphics block is positioned to the horizontal position. 


Position 
| 
V 
+-->+------------------------------- --- = -- - = + 
| 
| 
| 


+---Position 
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Appendix A. 


Printer Characteristics 


Some printers may not be able to print your output as designed. This appendix 
describes some of the printer characteristics, such as pel density and Single Byte 
(SBCS) and Double Byte (DBCS) Character Set support, that may affect the 
printout. For more information about printer characteristics, refer to the Advanced 
Function Printing: Printer Information, or appropriate documentation for your 
printer. 


Supported Printers 


Refer to IBM Printing Systems: Printer Information, (S544-5750), for more 
information about which IBM Advanced Function Printers are supported. For 
additional information, also refer to the IBM printers web page at 

http:/ /www.ibm.com/ printers. 


Printable Area 


Different printers have different printable areas. The printable area also depends on 
the paper size and the degree of rotation specified for the page layout or overlay 
used. 


You should specify the Offset prompt on the Define Overlay Specifications display 
or the Define PFD Specifications display so that your printout fits within the 
printable area of your printer. 


For information about the printable areas refer to the IBM Printing Systems: Printer 
Information, (S544-5750), or appropriate documentation for your printer. 


Printer Storage Limitations 


The data needed to print your printout is loaded into printer storage. With an 
unusually complex printout, the storage requirements may approach or exceed the 
storage limitations of the printer. If the storage limitations are exceeded, the 
printout will not be printed. If the storage used is close to the limitations, printing 
may be slowed somewhat. 


In such cases, you should consider simplifying your printout in one or more of the 
following ways: 


* Reduce the number of elements 

* Reduce the number of fonts 

* Reduce the number of page segments 

* Reduce the number of graphics 

* Avoid use of shading 

* Avoid use of dotted and dashed lines or boxes 
* Avoid use of enlarged or reduced characters 

* Use smaller fonts 


You should also consider purchasing more raster image storage for your printer if 
this is appropriate. 
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Appendix B. Rotation, Format, and Shading Pattern in Box 


Format, Text Placement and Rotation 


You can specify the rotation of an overlay or a page, and the text position in a box 


element. 


On the Define Box Detail display, you can specify the format, the text placement 
and the rotation in the Format prompt, in the Text placement prompt and in the 
Degree of rotation prompt respectively. 


Format 


You can specify the following values in the Format prompt. 


1 
2 
3 


Horizontal 

Vertical 

Vertical, right to left 

Note: The value 3 can be specified only when Y is specified for the user-specified 
DBCS data prompt on the Create Source Overlay File display or the Create PFD 
Definition File display and the iSeries system is double byte capable. 


Text Placement 


You can specify the following values in the Horizontal prompt and the Vertical 
prompt when the format is horizontal. 


* Horizontal prompt 


PWN 


Left 
Center 
Right 
Balance 


* Vertical prompt 


1 
2 
3 


Top 
Center 
Bottom 


You can specify the following values in the Horizontal prompt and the Vertical 
prompt when the format is vertical or vertical right to left. 


* Horizontal prompt 


1 
2 
3 


Left 
Center 
Right 


* Vertical prompt 


PWN 


Top 
Center 
Bottom 
Balance 
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Degree of Rotation 
You can specify 0, 90, 180, and 270 to rotate the text clockwise. 


The following print examples show various rotation and formats of the text. 


Table 85. Degree of rotation and rotation formats 


Format Degree of Rotation Degree of Rotation 
(Box) (Overlay or Page) 
Print example - 1 1 0 0 
Print example - 2 iL, 90 0 
Print example - 3 1 180 0 
Print example - 4 i 270 0 
Print example - 5 1 90 90 
Print example - 6 2 0 0 
Print example - 7 2 90 0 
Print example - 8 2 180 0 
Print example - 9 2 270 0 
Print example - 10 2 90 90 
Print example - 11 3 0 0 
Print example - 12 3 90 0 
Print example - 13 3 180 0 
Print example - 14 3 270 0 
Print example - 15 3 90 90 


420 AFP Utilities for iSeries: User’s Guide 


Choice on the Define Box Detail display: 


Format 1=Horizontal 

Degree of rotation : 0 

Some Some Some So me 
Lines of Text Lines of Text Lines of Text Lines of Text 
in a Box in a Box in a Box in aBox 
LEFT TOP CENTER TOP RIGHT TOP BALANCE TOP 
Some Some Some Soo me 
Lines of Text Lines of Text Lines of Text Lines of Text 
in a Box in a Box in a Box in aBox 


LEFT CENTER 


CENTER CENTER 


RIGHT CENTER 


BALANCE CENTER 


Some 
Lines of Text 
in a Box 


Some 
Lines of Text 
in a Box 


Some 
Lines of Text 


in a Box 


S ome 
Lines of Text 
in a Box 


LEFT BOTTOM 


CENTER BOTTOM 


Figure 34. Print Example - 1 


RIGHT BOTTOM 


BALANCE BOTTOM 
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Choice on the Define Box Detail display: 


Format 1=Horizontal 
Degree of rotation : 90 
= io 
5 3 = - 
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S Qa*y ooo 
+0 
5 8 3 x 
x ~o * 
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82 a3 an 
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oo awn 
Peed Q a ° Q id 
a! wos a a 
i Q a 3° o 2 
x ° o 
as amy er 
wal x 
ZX ne 
LEFT CENTER CENTER CENTER RIGHT CENTER BALANCE CENTER 
so9 = 
ao3 = = 3 
% oO = ow 
o a5 
g 2 2B un ° 
= a5 S 5 Giger 
x calm © 
+ ra) o =O eS 
x o! 3 e wo 
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Dals x 
QXo ae 
LEFT BOTTOM CENTER BOTTOM RIGHT BOTTOM BALANCE BOTTOM 


Figure 35. Print Example - 2 
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Choice on the Define Box Detail display: 


Format : 1l=Horizontal 
Degree of rotation : 180 


xog D ul xog D Ul xog D Ul xogb Ut} 
xe, Jo seul] xe, Jo seul] xe] Jo soul +xe] $O sauly 
awos awos awos UO S 
LEFT TOP CENTER TOP RIGHT TOP BALANCE TOP 
xog D Ul xog D Ul xog D ul xog Dp ul 
4xO] JO seUlq xe] Jo seulq +xX8, $O SOul] $xal fo seulq 
aos awos aiues oO! S 
LEFT CENTER CENTER CENTER RIGHT CENTER BALANCE CENTER 
xog D Ul xog D Ul xog D Ul xog bp Ut 
xe, Jo saul $x®] JO Seu!) #xO] JO SeUul] 4xoel $o seulq 
awos aWOS aWoS 2 wos 
LEFT BOTTOM CENTER BOTTOM RIGHT BOTTOM BALANCE BOTTOM 


Figure 36. Print Example -3 
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Choice on the Define Box Detail display: 


Format : 1l=Horizontal 
Degree of rotation : 270 


ot x + 
£ESg x * 
oF 
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ot x ee 
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Figure 37. Print Example - 4 
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Choice on the Define Box Detail display: 


Format 
Degree of rotation 


1=Horizontal 


Choice on the Define Overlay Specifications display or 
the Define PFD Specifications Display: 


Degree of rotation 


xog D Ul 
{xe Jo seul 
awoS 
xog D Ul 
{xe jo seul 
aWOS 
xog D Ul 
xe] Jo seul 
awos 
LEFT BOTTOM LEFT CENTER LEFT TOP 
xog D Ul 
x9, yo seulq 
ete> xog D ul 
xe, yo saul 
aWOS 
xog D Ul 
$xeL Jo SaUlq 
awos 
CENTER BOTTOM CENTER CENTER CENTER TOP 
xog Dp Ul 
{xX98L JO SaUlq 
awoSs 
xog Dp Ul 
fxa] yo seulq 
aWOS 
xog DB Ul 
{xeL yo seulq 
awWoS 
RIGHT BOTTOM RIGHT CENTER RIGHT TOP 
x O g ie) ul 
xe] fo saul q 
ea wo s 
x (O° -@ 2) ul 
$+xeal fo soaulq 
ea wos 
x O g ie} ul 
$xeol o saul 


BALANCE BOTTOM 


BALANCE CENTER 


Figure 38. Print Example - 5 
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Choice on the Define Box Detail display: 


Format : 2=Vertical 
Degree of rotation : 0 


SLi : ; 
a : sin 
eea ao” 
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Figure 39. Print Example - 6 


426 AFP Utilities for iSeries: User’s Guide 


Choice on the Define Box Detail display: 


Format : 2=Vertical 
Degree of rotation : 90 
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Figure 40. Print Example - 7 
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Choice on the Define Box Detail display: 


Format : 2=Vertical 
Degree of rotation : 180 
ey S 
x 
¥ ° quo o ° 
fo} as Fy . : Ss q air 
rs] pu u 
s eee u Do 
Doe ud S \ 
uw \ ue. S 
u 1o \1 
11S : 
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x o aw fea 
x fo 7 q uo 
a 1s a° 
° isi) . ww 
g u 1 
s 12] fo) u 
! u Bp 0 
Dao S 
7 | : 
Uw u ul | 
id tie: | u_s 
: 7 
qs ! 
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CENTER CENTER 
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Figure 41. Print Example - 8 
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RIGHT BOTTOM 


BALANCE BOTTOM 


Choice on the Define Box Detail display: 


Format : 2=Vertical 
Degree of rotation : 270 
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Figure 42. Print Example - 9 
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Choice on the Define Box Detail display: 


Format : 2=Vertical 
Degree of rotation : 90 


Choice on the Define Overlay Specifications display or 
the Define PFD Specifications Display: 


Degree of rotation 


x x x 
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Figure 43. Print Example - 10 
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LEFT BALANCE 


Choice on the Define Box Detail display: 


Format : 3=Vertical, right to left 
Degree of rotation : 0 
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Figure 44. Print Example - 11 
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Choice on the Define Box Detail display: 


Format 
Degree of rotation 


: 3=Vertical, right to left 


: 90 
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Figure 45. Print Example - 12 
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Choice on the Define Box Detail display: 


Format 


Degree of rotation 


180 


: 3=Vertical, right to left 


asx r 
Xx weo 38 
° oug . 
x s r) 
° ° aq S$} uw g 
Ww 2 
q u 
oD u 
Ss S ! u fo} pb 
aed Ty ! ! 
wu Sou 
o1u : a 
Si! . 
LEFT TOP LEFT CENTER LEFT BOTTOM LEFT BALANCE 
ties av 
x oug ee 
x 5 0 4 s 
° ®54q z° Ww q 
q u u 
. ots 
E) 
wu Ty S u 
ou | 
“ 1, 
ia ! 
CENTER TOP CENTER CENTER CENTER BOTTOM CENTER BALANCE 
asx 
w2eo s * 
x oug e6 
7 se S| @ 
° 254 7? w 4 
q wy u 
s a) u o D 
ead C2 1 
7 ! ! 
wu u ey 
o1u ! 7 
SH ! 
RIGHT TOP RIGHT CENTER RIGHT BOTTOM RIGHT BALANCE 


Figure 46. Print Example - 13 
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Choice on the Define Box Detail display: 


Format 
Degree of rotation : 270 


: 3=Vertical, right to left 
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Figure 47. Print Example - 14 
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RIGHT BALANCE 


Choice on the Define Box Detail display: 


Format : 3=Vertical, right to left 
Degree of rotation : 90 


Choice on the Define Overlay Specifications display or 
the Define PFD Specifications Display: 


Degree of rotation : 90 
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Figure 48. Print Example - 15 


Shading Pattern in Box 


You can specify the shading in a box element in the Shading pattern prompt and the 
Shading type prompt on the Define Box Detail display. 


When standard shading is selected, the degree of shading increases with the 
percentage the same way it does for screen shading. The difference between the 
two is that screen shading produces a screen-like pattern and standard shading 
produces a dot matrix not intended to be a pattern. 
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Following is an example of shading. 


0.01-5.99 6.00-8.99 9.00-11.99 12.00-14.99 15.00-17.99 18.00-20.99 


21.00-23.99 24.00-26.99 27.00-29.99 30.00-32.99 33.00-35.99 36.00-38.99 


39.00-41.99 42.00-44.99 45.00-47.99 48.00-50.99 51.00-53.99 54.00-56.99 


57.00-59.99 60.00-62.99 63.00-65.99 66.00-68.99 69.00-71.99 72.00-74.99 


75.00-77.99 78.00-80.99 81.00-83.99 84.00-86.99 87.00-89.99 90.00-92.99 
93.00-95.99 96.00-100.99 


Figure 49. Shading patterns 


When you specify the following choice for the Shading type prompt, the percentage 
ranges as shown are designated: 


Shade type Value (%) 

*LIGHT 24.00 - 26.99 
*MEDIUM 48.00 - 50.99 
*DARK 72.00 - 74.99 
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Appendix C. Rotation of Graphics 


You can specify the rotation of a graphics in a graphics element. 


a? End 
Start 
aro? End 


Figure 50. Rotation of graphics 
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Appendix D. Using GDFs in AFP Utilities 


IBM Advanced Function Printing Utilities for iSeries cannot create GDF in itself. 


Graphics data format (GDF) is a means of storing pictures. GDDM uses it 
internally, and also makes it available to application programs. It consists of a set 
of orders with similar meanings to the GDDM graphics call statements. In many 
cases there is a one-for-one mapping between GDF orders and GDDM call 
statements. 


You can create GDF easily by using Business Graphics Utility (BGU), and also by 
application programs. You can also create GDF on System/390. 


To use a System/390 GDF file, you must first convert the GDF file for use on the 
server. To convert the GDF file, use the GDF Bridge Utility of the Graphical 
Display and Query Facility (QGDF) Licensed Program. You can do conversions in 
either VM or in MVS/TSO. 


If the System /390 supports VM, type the following to start the GDF Bridge Utility 
and press Enter: 


EMGGDFB fn TOGDF |EXPAND| 


The entries in this procedure are as follows: 


The filename of a CMS file whose file type is ADMGDF. This file contains 


i the ADMGDF object. 
TOGDF Indicates that the specified file is to be converted to a GDF file. 
EXPAND Specifies that vector symbols and arcs be expanded to lines. 


If the System /390 supports MVS/TSO, type the following to start the GDF Bridge 
Utility and press Enter: 


EMGGDFB indsn outdsn member TOGDF |EXPAND| 


The entries in this procedure are as follows: 


indsn The fully qualified name of the dataset that contains the ADMGDF object. 
outdsn The fully qualified name of the dataset that is to contain the GDF object. 
The name of the member in the above datasets that contains the 
member : 
input/output. 


Specifies that the input member is to be converted into a GDF file and 
stored in the output member. 
EXPAND Specifies that vector symbols and arcs be expanded to lines. 


TOGDF 


The GDF file created by these procedures can then be migrated to the server for 
use by iSeries system. 


Note: GDFs created by System /390 GDDM releases subsequent to release 1.3 may 
not be supported by the system. 
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The following table shows the GDF orders generated by S/390, iSeries system, and 
the GDF orders supported by AFP Utilities. 


Table 86. GDF orders generated by S/390, iSeries system, and the GDF orders supported by 


AFP Utilities 
Order GDF generated GDF generated Support by 
by S/390 GDDM by iSeries AFP 
GDDM Utilities for 
iSeries 
00-No Operation - - Ignored? 
01-Comment Supported Supported Supported 
02-Process Specific Control Supported : Ignored * 
03-Push and Set Character Box Supported - Ignored 2 
04-Segment Characteristics Supported = Supported 
07-Call segment Supported - Ignored 2 
09-Push and Set Pattern Supported - Ignored 2 
0A-Set Color Supported - Supported ! 
0C-Set Foreground Color Mix Supported - Supported ! 
0D-Set Background Color Mix Supported - Supported : 
10-Set Text Alignment Supported - Ignored a 
11-Set Fractional Line Width Supported - Supported 
18-Set Line Type Supported Supported Supported 1 
19-Set Line Width Supported - Supported ? 
21-Set Current Position Supported - Supported 
22-Set Arc Parameters Supported Supported Supported 
23-Push and Set Pick (Tag) Identifier Supported - Ignored * 
24-Set Model Transform Supported - Ignored a 
26-Set Extended Color Supported Supported Supported 
27-Set Viewing Window Supported - Ignored = 
28-Set pattern Symbol Supported Supported Supported : 
29-Set Marker Symbol Supported - Supported zi 
33-Set Character Cell Supported Supported Supported 
34-Set Character Angle Supported Supported Supported 
35-Set Character Shear Supported Supported Supported 
36-Set Character-Box Spacing Supported - Ignored 2 
37-Set Marker Cell Supported - Supported 
38-Set Character Set Supported Supported Supported ! 
39-Set Character Precision Supported Supported Supported t 
3A-Set Character Direction Supported Supported Supported 1 
3E-End Prologue Supported - Supported a 
3F-Pop Attribute Supported - Ignored 2 
41-Marker Scale Supported - Ignored 2 
43-Set Pick Identifier Supported Supported Supported 
4A-Push and Set Color Supported - Ignored 2 
4C-Push and Set Foreground Color Mix Supported - Ignored . 
4D-Push and Set Background Color Mix Supported - Ignored e 
50-Push and Set Text Alignment Supported - Ignored 2 
51-Push and Set Fractional Line Width Supported - Ignored = 
53-Segment Position Supported - Ignored * 
58-Push and Set Line Type Supported - Ignored 2 
59-Push and Set Line Width Supported - Ignored 2 
60-End Area Supported Supported Supported 
61-Push and Set Current Position Supported - Ignored é 
62-Push and Set Arc Parameters Supported - Ignored 2 
64-Push and Set Model Transform Supported - Ignored 2 
66-Push and Set Extended Color Supported - Ignored e 
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Table 86. GDF orders generated by S/390, iSeries system, and the GDF orders supported by 


AFP Utilities (continued) 


Order 


GDF generated 


GDF generated Support by 


by S/390 GDDM by iSeries AFP 
GDDM Utilities for 
iSeries 

67-Push and Set Viewing Window Supported - Ignored . 
68-Begin Area Supported Supported Supported ! 
69-Push and Set Marker Type Supported - Ignored 2 
70-Segment Start Supported Supported Supported 
71-End Segment Supported Supported Supported 1 
72-Segment Attribute Supported Supported Ignored 2 
73-Segment Attribute Modify Supported - Ignored 2 
74-Push and Set Character Angle Supported - Ignored 2. 
75-Push and Set Character Shear Supported - Ignored 2 
76-Push and Set Character-Box Spacing Supported - Ignored 2 
77-Push and Set Marker Box Supported - Ignored 2 
78-Push and Set Character Set Supported - Ignored 2 
79-Push and Set Character Mode Supported - Ignored 2 
7A-Push and Set Character Direction Supported - Ignored - 
81-Line at Current Position Supported Supported Supported 
82-Marker at Current Position Supported - Supported 
83-Character String at Current Position Supported Supported Supported 
85-Fillet at Current Position Supported - Supported 
86-Arc at Current Position Supported Supported Ignored 2 
87-Full Arc at Current Position Supported - Ignored 2 
91-Begin Image Data at Current Position Supported Supported Ignored 2 
92-Image Data Supported Supported Supported 
93-End Image Supported Supported Supported 
A1-Relative line at current position Supported - Supported 
Cl1-Line Supported Supported Supported 
C2-Marker Supported - Supported 
C3-Character String Supported - Supported 
C5-Fillet Supported - Supported 
C6-Arc Supported 2 Ignored * 
C7-Full Arc Supported 2 Ignored * 
D1-Begin Image Supported - Ignored 2 
E1-Relative Line Supported - Supported 


Note: 


1 the order is supported and it is the short format, which has no length field. 


? finds this order, skips this order and handles the next order. 


Note: When AFP Utilities for iSeries finds an order which is not on this table, AFP 
Utilities for iSeries regards the file as an incorrect GDF file and exits from 


graphics handling. 
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Appendix E. How to Do a Task 


How to Use This Chapter 


This chapter provides a quick reference of tasks. You should have a basic 
knowledge of how to use the iSeries and the IBM Advanced Function Printing 
Utilities for iSeries. You must know the following rules used in the descriptions in 
this chapter. 

* "Enter” means to type the following data and press the Enter key. 

* If it is on a menu, "Enter n” (n is an option number like "Enter 2”) means to type 
an option number on the command line and press the Enter key. 

* If it is on a work with display, "Enter n" (n is an option number like "Enter 2") 
means to type an option number next to the item in the list and press the Enter 
key. 

* Not all details are described. For example, some required parameters are not 
described because they are shown on the display and explained in the online 
help information. 


Tasks Related to Source Overlays 


Note: The following description assumes that you are on a display with the 
command line. 


Table 87. Tasks related to source overlays 
Task How to Do the Task 


Create a source overlay Enter STRAFPU. 


Enter 1. 

Enter 1 and a source overlay name on the top of the list. 
Enter STRAFPU. 
Enter 1. 

Enter 2. 

Enter STRAFPU. 
Enter 1. 

Enter 3. 

Enter STRAFPU. 
Enter 1. 

Enter 4. 

Enter STRAFPU. 
Enter 1. 

Enter 6. 

Enter STRAFPU. 
Enter 1. 

Enter 7. 

Enter STRAFPU. 
Enter 1. 

Enter 9. 


Change a source overlay 


Copy a source overlay 


Delete a source overlay 


Print a source overlay 


Rename a source overlay 


Create an overlay object from 
a source overlay 
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Tasks Related to Source Overlay Files 


Note: The following description assumes that you are on a display with the 
command line. 


Table 88. Tasks related to source overlay files 


Task How to Do the Task 
Create a source overlay file 1. Enter STRAFPU. 
2. Enter 2. 


3. Enter 1, a source overlay file name, and a library 
name on the top of the list. 


Change a source overlay file 1. Enter STRAFPU. 
description text 2. Enter 2. 
3. Enter 2. 
Copy a source overlay file 1. Enter STRAFPU. 
2. Enter 2. 
3. Enter 3. 
Delete a source overlay file 1. Enter STRAFPU. 
2. Enter 2. 
3. Enter 4. 
Rename a source overlay file 1. Enter STRAFPU. 
2. Enter 2. 
3. Enter 7. 
Display a source overlay file 1. Enter STRAFPU. 
description 2. Enter 2. 
3. Enter 8. 


Tasks Related to PFD Definitions 


Note: The following description assumes that you are on a display with the 
command line. 


Table 89. Tasks related to PFD definitions 


Task How to Do the Task 


Create a PFD definition 1. Enter STRAFPU. 


2. Enter 11. 


3. Enter 1 and a PFD definition name on the top of 
the list. 


Enter STRAFPU. 
Enter 11. 

Enter 2. 

Enter STRAFPU. 
Enter 11. 

Enter 3. 

Enter STRAFPU. 
Enter 11. 

Enter 4. 


Change a PFD definition 


Copy a PFD definition 


Delete a PFD definition 
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Table 89. Tasks related to PFD definitions (continued) 


Task How to Do the Task 
Print a PFD definition 1. Enter STRAFPU. 
2. Enter 11. 
3. Enter 6. 
Rename a PFD definition 1. Enter STRAFPU. 
2. Enter 11. 
3. Enter 7. 
Print a database file with a PFD 1. Enter STRAFPU. 
definition 2. Enter 11. 
3. Enter 9. 


Tasks Related to PFD Definition Files 


Note: The following description assumes that you are on a display with the 
command line. 


Table 90. Tasks related to PFD definition files 


Task How to Do the Task 
Create a PFD definition file 1. Enter STRAFPU. 
2. Enter 12. 


3. Enter 1, a PFD definition file name, and a library 
name on the top of the list. 


Change a PFD definition file 1. Enter STRAFPU. 
description text 2. Enter 12. 
3. Enter 2. 
Copy a PFD definition file 1. Enter STRAFPU. 
2. Enter 12. 
3. Enter 3. 
Delete a PFD definition file 1. Enter STRAFPU. 
2. Enter 12. 
3. Enter 4. 
Rename a PFD definition file 1. Enter STRAFPU. 
2. Enter 12. 
3. Enter 7. 
Display a PFD definition file 1. Enter STRAFPU. 
description 2. Enter 12. 
3. Enter 8. 
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Tasks Related to Overlay Objects 


Note: The following description assumes that you are on a display with the 
command line. 


Table 91. Tasks related to overlay objects 


Task How to Do the Task 
Create an overlay object 1. Enter STRAFPU. 
2. Enter 1. 
3. Enter 9. 
Change an overlay object Change the source overlay and create the overlay 


object again. 


Copy an overlay object 1. Enter STRAFPU. 
2. Enter 22. 
3. Enter 3. 
Delete an overlay object 1. Enter STRAFPU. 
2. Enter 22. 
3. Enter 4. 
Print an overlay object 1. Enter STRAFPU. 
2. Enter 22. 
3. Enter 6. 
Rename an overlay object 1. Enter STRAFPU. 
2. Enter 22. 
3. Enter 7. 
Display an overlay object text 1. Enter STRAFPU. 
description 2. Enter 22. 
3. Enter 8. 
Convert an overlay object to a 1. Enter STRAFPU. 
physical file member 2. Enter 22 
3. Enter 9. 
Change an overlay object description 4. Enter STRAFPU. 
text 2. Enter 22. 
3. Enter 13. 


Tasks Related to Page Segments 


Note: The following description assumes that you are on a display with the 
command line. 


Table 92. Tasks related to page segments 


Task How to Do the Task 
Create a page segment 1. Enter STRAFPU. 
2. Enter 21. 
Change a page segment Change the image in a PC document and create the 
page segment again. 
Copy a page segment 1. Enter STRAFPU. 
2. Enter 23. 
3. Enter 3. 
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Table 92. Tasks related to page segments (continued) 


Task 


How to Do the Task 


Delete a page segment 


Print a page segment 


Rename a page segment 


Display a page segment description 


Convert a page segment object to a 


physical file member 


Change a page segment description 
text 
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Enter STRAFPU. 
Enter 23. 

Enter 4. 

Enter STRAFPU. 
Enter 23. 

Enter 6. 

Enter STRAFPU. 
Enter 23. 

Enter 7. 

Enter STRAFPU. 
Enter 23. 

Enter 8. 

Enter STRAFPU. 
Enter 23. 

Enter 9. 

Enter STRAFPU. 
Enter 23. 

Enter 13. 


Tasks Related to Screen View of Design Display 


Note: The following description assumes that you are on one of the following 


displays and in the screen view: 


The Design Overlay display 


The Design Record Layout display 


The Design Page Layout display 


Defining an Element 


Table 93. Defining an element in the screen view of the design display 


Task 


How to Do the Task 


Define a text element 


Define a line element 


Define a box element 


ON edNeS 


Position the cursor in the image area. 
Press the F6 key. 
Position the cursor in the image area. 
Press the F9 key. 


Position the cursor at another position in the 
image area. 


Press the F9 key. 
Position the cursor in the image area. 
Press the F10 key. 


Position the cursor at another position in the 
image area. 


Press the F10 key. 
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Table 93. Defining an element in the screen view of the design display (continued) 


Task How to Do the Task 


Define a bar code element Position the cursor in the image area. 


Press the F11 key. 

Position the cursor in the image area. 
Press the F13 key. 

Press the F6 key. 


Position the cursor at another corner in the image 
area. 


Press the F6 key. 

Position the cursor in the image area. 
Press the F13 key. 

Press the F9 key. 

Position the cursor in the image area. 
Press the F13 key. 

Press the F11 key. 


Define a graphics element 


Pees Nos 


Define a page segment element 


Define a record layout element 
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Handling Existing Elements 


Table 94. Handling existing elements in the screen view of the design display 


Task How to Do the Task 


Change an element Position the cursor to the element mark. 


Press the F14 key. 

Position the cursor to the element mark. 
Press the F21 key. 

Position the cursor to a new position. 
Press the F6 key. 

Position the cursor to the element mark. 
Press the F21 key. 

Position the cursor to a new position. 
Press the F9 key. 

Position the cursor to the element mark. 
Press the F21 key. 

Press the F10 key. 

Position the cursor at a corner of the block. 
Press the F22 key. 


Position the cursor at the diagonal corner of the 
block. 


Press the F22 key. 
Position the cursor to a new position. 
Press the F6 key. 


Copy an element 


Move an element 


Remove an element 


Copy a block of elements 
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Table 94. Handling existing elements in the screen view of the design display (continued) 
Task How to Do the Task 


Move a block of elements 1. Position the cursor at a corner of the block. 
2. Press the F22 key. 


3. Position the cursor at the diagonal corner of the 
block. 


Press the F22 key. 

Position the cursor to a new position. 
Press the F9 key. 

Position the cursor at a corner of the block. 
Press the F22 key. 


Position the cursor at the diagonal corner of the 
block. 


4. Press the F22 key. 
5. Press the F10 key. 


Remove a block of elements 


a 


Changing the View of the Display 


Table 95. Changing the view of the display in the screen view of the design display 
Task How to Do the Task 


Hide marks Press the F15 key. 


Press the F15 key. 


Position the cursor to the element. 
Press the F16 key. 


Display marks again 
Temporarily remove an element 
from the image area (Hide an 
element) 

Display the temporarily removed 1. Press the F5 key. 
elements again 
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Tasks Related to List View of Design Display 


Note: The following description assumes that you are on one of the following 
displays and in the list view: 


The Design Overlay display 
The Design Record Layout display 
The Design Page Layout display 


Defining an Element 


Table 96. Defining an element in the list view of the design display 
Task How to Do the Task 


Define a text element Press the F6 key. 


Press the F9 key. 
Press the F10 key. 
Press the F11 key. 
Press the F13 key. 
Press the F6 key. 


Define a line element 
Define a box element 
Define a bar code element 


Define a graphics element 
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Table 96. Defining an element in the list view of the design display (continued) 


Task How to Do the Task 


Define a page segment element . Press the F13 key. 


. Press the F9 key. 
. Press the F13 key. 
. Press the F11 key. 


1 

2 
Define a record layout element 1 
2 


Handling Existing Elements 


Table 97. Handling existing elements in the list view of the design display 


Task How to Do the Task 


Change an element Position the cursor on the line of the element. 


Press the F14 key. 
Position the cursor on the line of the element. 
Enter C in the NBR column. 


Enter a new position. 


Copy an element 


Move an element Position the cursor on the line of the element. 


Enter M in the NBR column. 


Enter a new position. 


Remove an element Position the cursor on the line of the element. 


Enter R in the NBR column. 


Restore an element Position the cursor on the line of the element. 


Enter S in the NBR column. 
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Tasks Related to Each Element 


Text Element 


Note: The following description assumes that you are on one of the following 
displays: 


The Define Text Detail display 
The Change Text Detail display 
The Define Box Detail display 
The Change Box Detail display 


Table 98. Tasks related to text element 


Task How to Do the Task 


Specify values of a variable field as Enclose the field name with & and . like: 
text &PRODCT. 


Note: This is allowed on the Record Layout only. 
Change the mark to a meaningful Specify the name in the Element prompt. 


name 
Print the text vertically Specify 2 or 3 in the Format prompt. 
Rotate the text Specify 90, 180, or 270 in the Degree of Rotation 


prompt. 
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Table 98. Tasks related to text element (continued) 


Task How to Do the Task 
Print the text in a color other than Specify the color in the Color prompt. 
black 
Note: See IBM Printing Systems: Printer Information, 
(S544-5750), for more informations. 
Draw underline with the text Specify Y in the Underline prompt. 
Type a character over the text Specify the character in the Overstrike prompt. 
Print the text with a different font Specify the font number in the Font prompt. 
Print a DBCS text Specify the font number in the DBCS font prompt. 
Print text in different size Specify the size in the Character size prompt. 


Note: The following description assumes that you are on one of the following 
displays: 


The Define Box Detail display 
The Change Box Detail display 


Table 99. Tasks related to text element 


Task How to Do the Task 

Specify multiple lines of text Enclose each line in two apostrophes like: 
‘first line' ‘second line' 

Align multiple lines of text Specify 1, 2, 3, or 4 in the Horizontal prompt. 

horizontally 

Align multiple lines of text Specify 1, 2, 3, or 4 in the Vertical prompt. 

vertically 


Not to print box. (Print text only) Specify 0 in the Line width prompt. 


Line Element 


Note: The following description assumes that you are on one of the following 
displays: 


The Define Line Detail display 
The Change Line Detail display 


Table 100. Tasks related to line element 


Task How to Do the Task 

Change the mark to a meaningful Specify the name in the Element prompt. 

name 

Print a dashed line Specify 2 in the Line type prompt. 

Print a dotted line Specify 3 in the Line type prompt. 

Print with wider or narrower line Specify the width in the Line width prompt. 
Print the line around rows and Specify 2 in the Line placement prompt and use 
columns Row/Column for the measurement method. 
Print the line in the middle of rows Specify 1 in the Line placement prompt and use 
or columns Row/Column for the measurement method. 


Box Element 


Note: The following description assumes that you are on one of the following 
displays: 
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The Define Box Detail display 


The Change Box Detail display 


Table 101. Tasks related to box element 


Task 


How to Do the Task 


Change the mark to a meaningful 
name 

Print the box with dashed line 

Print the box with dotted line 

Print the box with wider or narrower 
line 

Print the box around rows and 
columns 

Print the box in the middle of rows 
or columns 

Shade the area inside of the box with 
patterns 


Specify the name in the Element prompt. 


Specify 2 in the Line type prompt. 
Specify 3 in the Line type prompt. 
Specify the width in the Line width prompt. 


Specify 2 in the Line placement prompt and use 
Row/Column for the measurement method. 
Specify 1 in the Line placement prompt and use 
Row/Column for the measurement method. 
Specify 1 or 2 in the Pattern prompt. 


Bar Code Element 


Note: The following description assumes that you are on one of the following 


displays: 


The Define Bar Code Detail display 
The Change Bar Code Detail display 


Note: Some bar code types do not allow some of the following operations. 


Table 102. Tasks related to bar code element 


Task 


How to Do the Task 


Change the mark to a meaningful 
name 

Specify values of a variable field as 
a bar code 


Print the bar code vertically 
Rotate the bar code 


Print the bar code in a color other 
than black 


Print the bar code with a check 
digit 

Print the bar code with text of the 
bar code data 

Print asterisks with the text of the 
bar code data 

Print the text of bar code data with 
different font 

Print bar code in different width 
Print bar code in different height 
Print the bar code with different 
width ratio of bar and space 


Specify the name in the Element prompt. 


Enclose the field name with & and . like: 
&PRODCT. 


Note: This is allowed on the Record Layout only. 
Specify 90 or 270 in the Degree of rotation prompt. 
Specify 90, 180, or 270 in the Degree of Rotation 
prompt. 

Specify the color in the Color prompt. 

Note: See IBM Printing Systems: Printer Information, 
(S544-5750), for more information. 
Specify Y in the Check digit prompt. 


Specify Y in the HRI prompt. 

Specify Y in the HRI asterisk prompt. 

Specify the font number in the HRI font prompt. 
Specify another value in the Module width prompt. 
Specify another value in the Element height prompt. 


Specify another value in the Wide to narrow ratio 
prompt. 
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Graphics Element 
Note: The following description assumes that you are on one of the following 
displays: 
The Place Graphics Detail display 
The Change Graphics Detail display 


Table 103. Tasks related to graphics element 


Task How to Do the Task 

Change the mark to a meaningful Specify the name in the Element prompt. 

name 

Rotate the graphics Specify 90, 180, or 270 in the Degree of Rotation 
prompt. 


Print the text of graphics data with Specify the font number in the Font prompt. 
different font 

Specify values of a variable field as _—_ Enclose the field name with & and . like: 
graphics object name &PRODCT. 


Note: This is allowed on the Record Layout only. 


Page Segment Element 
Note: The following description assumes that you are on one of the following 
displays: 
The Place Page Segment Detail display 
The Change Page Segment Detail display 


Table 104. Tasks related to page segment element 


Task How to Do the Task 

Change the mark to a meaningful Specify the name in the Element prompt. 
name 

Specify values of a variable field as Enclose the field name with & and . like: 
page segment name &PRODCT. 


Note: This is allowed on the Record Layout only. 


Record Layout Element 


Note: The following description assumes that you are on one of the following 
displays: 


The Place Record Layout Detail display 
The Change Record Layout Detail display 


Table 105. Tasks related to record layout element 


Task How to Do the Task 

Change the mark to a meaningful Specify the name in the Element prompt. 
name 

Print the record layout in the page Specify the repetition number in the Repetition 
more than once prompt. 
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Table 105. Tasks related to record layout element (continued) 


Task How to Do the Task 


Change the sequence of repeated Specify 1 or 2 in the Direction prompt. 
records in the page 

Change the distances between record Specify the distance in the Distance prompt. 
layouts 


Tasks Related to Database File Selection 


Note: The following description assumes that you are on the Specify Database File 


1. 


4. 


display. 
Type the database file name in the Database file prompt, or show the list of the 
database file names by pressing the F4 key and select one. 
Type the library name in the Library prompt. 


Type the record format name in the Record format prompt, or show the list of 
the record format names by pressing the F4 key and select one. 


Press Enter. 


Tasks Related to Record Selection 


Note: The following description assumes that you are on the Specify Record 


1. 


Selection display. 
Type the field name in the Field F4 for list column, or show the list of the field 
names by pressing the F4 key and select one. 


. Type one of the following test names in the Test column. 


* EQ 
* NE 
° LE 
* GE 
° LT 
° GT 
¢ RANGE 


. Type the value in the Value (Field, number, or ‘character’) column or show the list 


of the field names by pressing the F4 key and select one. 

If you specify more than one conditions, type AND or OR in the AND/OR 
column, the field name in the Field column, the test name in the Test column, 
and the value in the Value column. 


4. Press Enter. 


Tasks Related to Overlay Specifications and PFD Specifications 


Note: The following description assumes that you are on one of the following 


displays: 
The Define Overlay Specifications display 
The Define PFD Specifications display 
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Table 106. Tasks related to overlay specifications and PFD specifications 


Task How to Do the Task 

Change the printer type Specify another value in the Printer type prompt. 
Change the column position width Specify another value in the Characters per inch 
(characters per inch) prompt. 

Change the row position height Specify another value in the Lines per inch prompt. 
(lines per inch) 

Use inches to specify positions Specify 1 in the Unit of measure prompt and use Inch 


for the measurement method by pressing the F6 key 
when you define or change an element. 

Use centimeters to specify positions Specify 2 in the Unit of measure prompt and use 
Centimeter for the measurement method by pressing 
the Fé key when you define or change an element. 

Change the size of overlay or page Specify another value in the Size prompt. 

Rotate the overlay or page Specify 90, 180, or 270 in the Degree of rotation 
prompt. 

Not to print shift-out and shift-in Specify N in the DBCS SO/SI spacing prompt. 

characters as blanks 

Print the overlay or page to a distant Specify the offset value in the Offset prompt. 

position from the page origin 

Print grids with the overlay or page This is done on another display. 

layout to help your design work * To print grids with an overlay, specify Y in the 

Include grid prompt on the Create Overlay display. 
¢ To print grids with a page layout, specify Y in the 
Include grid prompt on the Print Database File 
Member display. 
Change the pitch of the grid Specify the value in the Grid prompt. 


Tasks Related to Font 


Note: The following description assumes that you are on one of the following 
displays: 


The Work with Source Overlay Fonts display 
The Work with PFD Definition Fonts display 
Table 107. Tasks related to font 


Task How to Do the Task 
View current definitions 1. Enter 5. 
Specify a font with a font and 1. Enter 2. 
character identifier 

2. Enter 1. 
Specify a font with a coded font 1. Enter 2. 

2. Enter 2. 
Specify a font with a code page and 4. Enter 2. 
a font character set 

2. Enter 3. 
Return a font to the initial font 1. Enter 9. 
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Task Related to Printout Specifications 


Note: The following description assumes that you are on the Define Printout 
Specifications display. 


Table 108. Tasks related to printout specifications 


Task How to Do the Task 

Print more than one copy Specify the number in the Copies prompt. 

Print even though there are some Specify *CONTENT in the Print fidelity prompt. 
errors 

Print as good of quality as possible Specify *NLQ in the Print quality prompt. 

Print as fast as possible Specify *DRAFT in the Print quality prompt. 
Print on both sides of the paper Specify Y in the Duplex prompt. 


Inform the operator to change the Specify a form name in the Form type prompt. 
form when it is printed 


Use the paper in an alternate Specify a number in the range of 2-255, *E1, or *CUT 

drawer in the Source drawer prompt. 

Print an overlay with the printout Specify the overlay name in the Front side overlay 
prompt. 

Print a different overlay on the Specify the overlay name in the Back side overlay 

other side of paper with the prompt. 

printout 


Task Related to Mapping Object 


Note: The following description assumes that you are on the Specify Mapping 
Object Name display. 


Table 109. Tasks related to mapping object 


Task How to Do the Task 
Specify mapping object name 1. Select the object type you want to specify the 
mapping. 


2. Specify the pair of the database field value and 
the object name to which the field value should 
be mapped. 


Task Related to Break Fields 


Note: The following description assumes that you are on the Specify Break Fields 


display. 
Table 110. Tasks related to break fields 
Task How to Do the Task 
Specify field in the list as a break Enter 1 on the Opt field. 
field. 
Cancel a break field in the list. Clear the Opt field with a blank. 
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Appendix F. Portability to Other Systems 


The IBM Advanced Function Printing Utilities for iSeries generates AFPDS for 
resources (overlays and page segments) and spooled files. AFPDS is compatible 
between the iSeries and other systems such as MVS, VM, and DOS/VSE. Therefore 
the resources and spooled files created by the IBM Advanced Function Printing 
Utilities for iSeries can be basically used on other systems that support AFPDS 
resources and spooled files except with the following restrictions. 


Even though you avoid all these restrictions, there may be cases when you cannot 
print the resources or spooled files correctly. You should verify that the printout is 
satisfactory when it is printed on other systems. 


The IBM Advanced Function Printing Utilities for iSeries Version 2 Release 3 and 
later releases has the function to convert overlay objects and page segments on the 
iSeries system to physical database files which can be used on VM, MVS, or the 
OS/2 system. You can send the converted files to those systems using the 
communication function or the iSeries Access on the server. 


Note: The IBM Advanced Function Printing Utilities for iSeries does not provide 
the functions to send the resources and spooled files from the server. 


Restrictions 


IPDS Towers 


The IBM Advanced Function Printing Utilities for iSeries uses the following IPDS 
data-type towers: 


Table 111. IPDS data-type towers 


Data type IPDS tower 

Text PT1 PT2 

IM image IM1 

IO image IO1 (IOCA function set 10) 
Graphics DR1 DR2 

Bar codes BC1 (for printer type 1, 2, 3, 9) 


PT1 (for printer type 4, 5, 6) 


If the resource contains an IPDS tower that is not supported by the target printer, 
the resource cannot be used. For example, you cannot use resources containing bar 
code (BC1 tower) on the 3820 printers. 


To avoid this restriction, you should specify only those printers that support the 
print towers used in the overlay specifications or the PFD specifications. 


PT2 Tower (Underline and Overstrike) 


If you specify Y for the Underline prompt or a character for the Overstrike prompt 
on the Define Text Detail display or the Define Box Detail display, the IBM 
Advanced Function Printing Utilities for iSeries generates PT2 tower data stream 
for the text. 
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You can print it on printers that do not support the PT2 tower if the printer is 
attached to the iSeries system, because the PT2 data stream is converted to the 
corresponding PT1 data stream if necessary. However, you can not print it on 
printers that do not support PT2 tower if the printer is attached to systems other 
than the iSeries system, because the PT2 to PT1 conversion is not supported. 


Fonts 


There are two kinds of fonts. The first kind of font resides in the printer and is 
specified with the font and character identifier. You can specify this kind of font by 
specifying 1 for the Font type prompt on the Change Source Overlay Font display 
or the Change PFD Definition Font display. 


The other kind of font resides on the iSeries system that the printer is attached to 
as resident fonts. The printer, when it requires a font, issues a font download 
request to the system for the required font or fonts. After this request, the server 
downloads the fonts to the printer. These fonts are specified with coded font name 
or a pair of the code page name and the character set name. You can specify the 
font by selecting 2 or 3 for the Font type prompt on the Change Source Overlay 
Font display or the Change PFD Definition Font display. 


Not all printers support both kinds of fonts. If the resource contains a font that is 
not supported by the target printer, the resource cannot be used. For example, you 
cannot use the first kind of font (printer resident) on the 3820 printers. 


You may use a printer even though you specify an incompatible font, if the printer 
is attached to the iSeries system, because fonts are substituted if necessary. 
However, you can not print it on the same printer if the printer is attached to 
systems other than the iSeries system, because the font substitution is not 
supported. 


Note: Font substitution is supported by other systems from the following release. 
You can avoid this restriction by using the following releases: 


e PSF/MVS Version 2 Release 1 or later 
¢ PSF/VM Version 2 Release 1 or later 


It is your responsibility to verify that the fonts you specified are substituted 
correctly. 


Other systems may not have the same font resources as the iSeries. You cannot 
print overlays or spooled files if the necessary font resources do not reside in the 
other system. It is your responsibility to verify that the fonts you specified reside 
in the system and are the same as the iSeries system. 


Page Segments 


If you include page segments in overlays or spooled files, you also have to send 
those page segments to the target system. 


PSF (Print Service Facility) 
The support level of AFPDS structured fields depends on the system and the 
release of PSF*. It is your responsibility to verify that your release level of PSF 
supports AFPDS structured field used in its resources (overlays and page 
segments) and spooled files. 
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Appendix G. Sample Overlays and Sample PFD Definitions 


Some samples of overlays and PFD definitions are shipped with the AFP Utilities 
for iSeries program. They are copied in the QGPL library automatically when you 
install the AFP Utilities for iSeries program. 


Sample Overlays 


Some samples of overlays are provided. The overlays can be used instead of the 
preprinted forms for the IBM iSeries Distributors Management Accounting System 
(DMAS) and the Manufacturing Accounting and Production Information Control 
System /Database (MAPICS*/DB). 


You can copy the source overlays from library QGPL, change the newly created 
source overlays, and create new overlays for your iSeries application programs. For 
example, you can include the company name in the overlay. 


You should choose a source overlay file for your printer from the following list: 
Source Overlay File Description 


QAFCXMPOV1 Sample overlays for the 4224, the 4234, and the 4230 printer 
QAFCXMPOV2 Sample overlays for the 3812 and the 3816 printer 
QAFCXMPOV3 Sample overlays for the 3916 and the 4028 printer 
QAFCXMPOV4 Sample overlays for the other printers 


Some sample source overlays are not contained in all source overlay files due to 
certain printer restrictions such as the maximum size of the overlay. 


Note: These samples have not been thoroughly tested under all conditions. It is 
your responsibility to change source overlays if necessary. 


DMAS Forms 


The overlays for DMAS (IBM iSeries DISTRIBUTORS MANAGEMENT 
ACCOUNTING SYSTEM) preprinted forms are provided. DMAS is actually made 
up of the following 10 program products: 


5728-D48 Accounts Payable 

5728-D42 Accounts Receivable 

5728-D41 Billing 

5728-D4X Cross Application System Support 
5728-D47 General Ledger 

5728-D43 Inventory Control 

5728-D46 Inventory Management 

5728-D45 Purchasing 

5728-D44 Sales Analysis 

5728-D49 Payroll 


The following source overlays are provided: 


Source Overlay Description 

DMAS_XMP_1 Accounts Payable remittance advice 
DMAS_XMP_2 Delinquency notice 

DMAS_XMP_3 Purchase order 
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MAPICS/DB Forms 


The overlays for MAPICS/DB (Manufacturing Accounting and Production 
Information Control/Data Base) preprinted forms are provided. MAPICS/DB is 
actually made up of the following 18 program products: 


5728-M7X 
5728-M73 
5728-M74 
5728-M7G 
5728-M7H 
5728-M7L 
5728-M77 
5728-M75 
5728-M7J 
5728-M7B 
5728-M79 
5728-M72 
5728-M76 
5728-M71 
5728-M7S 
5728-M7K 
5728-M7R 
5728-M78 
5706-287 


Cross Application Support 

Accounts Payable 

Accounts Receivable 

Capacity Planning 

Financial Analysis 

Forecasting 

General Ledger 

Inventory Management 

Master Production Schedule Planning 
Material Requirements Planning 
Order Entry and Invoicing 

Payroll 

Product Data Management 

Production Control and Costing 
Production Monitoring and Control 
Purchasing 

Repetitive Production Management 
Sales Analysis 

Manufacturing Performance Analysis 


The following source overlays are provided: 


Source Overlay 


MPCS_XMP_1 
MPCS_XMP_2 
MPCS_XMP_3 


Description 

Invoice type 1 form 
Invoice type 2 form 
Purchase order 


Sample PFD Definitions 


Some samples of PFD definitions and database files are provided. The PFD 
definitions would be used to print bar code labels for standard labels. 


You can copy the PFD definitions from library QGPL, change the newly created 
PFD definitions, and print your bar code labels. For example, you can include your 
company name in the label. 


You should choose a PFD definition file for your printer from the following list: 


PFD Definition File 


QAFCXMPPF1 
QAFCXMPPF2 
QAFCXMPPF3 
QAFCTUTPFD 
QAFCTUTXMP 


Description 

Sample overlays for the 4224, the 4234, and the 4230 printer 
Sample PFD definitions for the 3812 and the 3816 printer 
Sample PFD definitions for the 3916 and the 4028 printer 

AFP Utilities for iSeries tutorial PFD file 

Sample PFD File with tutorial example 


Some sample PFD definitions are not contained in all PFD definition files due to 
certain printer restrictions such as the maximum size of the overlay. 


Note: These 


samples have not been thoroughly tested under all conditions. It is 


your responsibility to change PFD definitions if necessary. 


460 AFP Utilities for iSeries: User’s Guide 


AIAG (Automotive Industry Action Group) Labels 
The following PFD definitions for AIAG labels are provided. 


PFD 

Definition Description 

AIAG_B2_HA AIAG-B2 (Vehicle ID Number Label) Horizontal bar code with HRI above 
AIAG_B2_HB AIAG-B2 (Vehicle ID Number Label) Horizontal bar code with HRI below 
AIAG _B3_SP AIAG-B3 Shipping/Parts Identification Number Label 

AIAG_B3_ ML AIAG-B3 Master Label 

AIAG_B3_LL AIAG-B3 Mixed Load Label 

AIAG_B4 PL AIAG-B4 Part Label 

AIAG_B4_ PT AIAG-B4 Part and Traceability data on a single line 

AIAG_B4_PD AIAG-B4 Part, Traceability data, and supplier on a separate line 
AIAG_B5 PM AIAG-B5 Primary Metals Identification Tag 


The following database files are provided as input files for the sample PFD 


Definitions: 

File Name Record Format Description 

QAFCXMPAI2 VINLBL Sample database file (AIAG_B2) 
QAFCXMPAI3 SPILBL Sample database file (AIAG_B3) 
QAFCXMPAI4 IPLBL Sample database file (AIAG B4) 
QAFCXMPAI5 SMPILBL Sample database file (AIAG_B5) 


EIA (Electronic Industries Association) Labels 
The following PFD definitions for EIA labels are provided: 


PFD 

Definition Description 

EIA_SMPL_1 Single Order Label (Single Product/Single Package) 
EIA_SMPL_2 Mixed Load Label (Single Order/Multiple Product ID's) 

EIA SMPL_3 Multiple Order Label (Multiple Orders/Single Product ID) 
EIA_SMPL_4 Multiple Load Label (Multiple Orders/Multiple Product ID's) 


The following database file is provided as an input file for the sample PFD 
Definitions: 


File Name Record Format Description 
QAFCXMPEIA  SHPLBL Sample database file (EIA) 


AFP Utilities Tutorial PFD Definitions 


The following PFD definitions are provided as part of the AFP Utilities tutorial. 


PFD 

Definition Description 

TUTORIAL Entire tutorial 

TUTOR10 Overview - Topics covered in the tutorial 
TUTOR20 Create Source Overlay file and Source Overlay 
TUTOR25 Create Source Overlay 

TUTOR30 Create the database file and add data with DFU 
TUTOR32 Create the database file - no data 

TUTOR40 Add data to the database file with DFU 

TUTOR50 Create PFD File, Create and Change a PFD 

TUTOR55 Create a PFD Definition 

TUTOR57 Change a PFD Definition 

TUTOR60 Print PFD Data 

TUTOR70 Copy a PFD Definition 

TUTOR80 Convert a page segment to a physical file member 
TUTOR9O Convert a physical file member to a page segment 


The following database files are provided as an input files for the AFP Utilities 


tutorial. 

File Name Record Format Description 

QAFCTUTDBF = -FORMAT1 SAMPLE DATABASE FILE FOR TUTORIAL 
QAFCTUTOR TUTORTXT AFPU TUTORIAL TEXT 


Appendix G. Sample Overlays and Sample PFD Definitions 461 


462 AFP Utilities for iSeries: User’s Guide 


Appendix H. Code 128 Character Set 


Table 112. Code 128 character set 


Character Hex Character Hex Character Hex Character Hex 
NUL 00 4B i 89 I C9 
SOH 01 < 4C FNC 1 8F } DO 
STX 02 ( 4D j 91 J D1 
ETX 03 + 4E k 92 K D2 
HT 05 | 4F l 93 L D3 
VT OB & 50 m 94 M D4 
FF 0C ! 5A n 95 N D5 
CR 0D $ 5B fe) 96 O D6 
SO OE ‘i 5C P 97 P D7 
SI OF ) 5D q 98 Q D8 
DLE 10 ‘ 5E r 99 R D9 
Del 11 -- 60 : Al \ EO 
DC2 12 / 61 Ss A2 S E2 
DC3 13 J 6B t A3 T E3 
BS 16 % 6C u A4 U E4 
CAN 18 - 6D v A5 Vv E5 
EM 19 > 6E w A6 WwW E6 
GS 1D ? 6F x A7 X E7 
RS 1E : 79 y A8& Y E8 
US 1F 7A AY Z E9 
FS 22 # 7B BO FNC 2 EA 
LF 25 @ 7C [ BA 0 FO 
ETB 26 ’ 7D ] BB 1 Fl 
ESC 27 = 7E FNC 4 BE 2 F2 
ENQ 2D “ 7F { CO 3 F3 
ACK 2E a 81 A Cl 4 F4 
BEL 2F b 82 B C2 5 F5 
SYN 32 c 83 Cc C3 6 F6 
EOT 37 d 84 D C4 7: F7 
DC4 3C e 85 E C5 8 F8 
NAK 3D f 86 F C6 9 F9 
SUB 3F g 87 G C7 FNC 3 FA 
SP 40 h 88 H C8 DEL FF 
Note: The printer or AFP Utilities for iSeries generate all START, STOP, SHIFT, and CODE 
characters in order to produce the shortest bar code possible from the given data. 
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Appendix I. Font Samples 


This appendix presents a sampling of various fonts provided by IBM. Refer to IBM 
AFP Fonts: Font Samples for a more complete description and illustration of fonts 
provided by IBM. 


Times New Roman Medium 


FONT NAME Point Character 
Size Set 


Times New Roman Medium 6pt 6 CON20060 
Times New Roman Medium 7pt 7 CON20070 
Times New Roman Medium 8pt 8 CON20080 
Times New Roman Medium 9pt 9 CON20090 

0) 

] 

2 


Times New Roman Medium 10pt CON20000 


Times New Roman Medium 11pt CON200A0 
Times New Roman Medium 12pt CON200B0 
Times New Roman Medium 14pt 4 CON200D0 
Times New Roman Medium 1 6pt 6 CON200F0 
Times New Roman Medium 18pt 8 CON200HO 
Times New Roman Medium 20pt 20 CON200/0 
Times New Roman Medium 24pt 24 CONz0DNO 


Times New Roman Medium 30pt x coz 


Times New Rom Med 36pt . « ci 


Figure 51. Times New Roman Medium 
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Helvetica Roman Bold 


FONT NAME Point Character 
Size Set 


COH40060 


Helvetica Roman Bold 6pt 


Helvetica Roman Bold 7pt : COH40070 
Helvetica Roman Bold 8pt 8 COH40080 
Helvetica Roman Bold 9pt 9  COH40090 
Helvetica Roman Bold 10pt 0 COH40000 
Helvetica Roman Bold 11pt 1 COH400A0 
Helvetica Roman Bold 12pt 2 COH400B0 
Helvetica Roman Bold 14pt 4 COH400D0 
Helvetica Roman Bold 16pt 6 COH400FO 
Helvetica Roman Bold 18pt 8 COH4OOHO 
Helvetica Roman Bold 20pt 20 coH400u0 
Helvetica Roman Bold 24pt 24 coNeOONO 


Helvetica Roman Bold 30pt | ss. 
Helvetica Rom Bld 36pt .. ...... 


Figure 52. Helvetica Roman Bold 


Courier 
FONT NAME Point Character 
Size Set 
Courier Roman Medium 7pt 7 ©0420070 
Courier Roman Medium 8pt 8 C0420080 
Courier Roman Medium 10pt 10 ©0420000 
Courier Roman Medium 12pt 12 0420080 
Courier Roman Medium 14pt 14 C04200D0 
Courier Roman Medium 20pt 20 C0420040 
Courier Roman Bold 7pt 7 ©C0440070 
Courier Roman Bold 8pt 8 C0440080 
Courier Roman Bold 10pt 10 ©0440000 
Courier Roman Bold 12pt 12 C04400B0 
Courier Roman Bold 14pt 14 C04400D0 
a 
Courier Roman Bold 20pt 20 co4400J0 
Courier Italic 7pt 7 ©0430070 
Courier Italic 8pt 8 C0430080 
Courier Italic 10pt 10 ©C0430000 
Courier Italic 12pt 12 C04300B0 
Courier Italic 14pt 14 C04300D0 
Courier Italic ZODE 20 C04300J0 
Courier Italic Bold 7pt 7 ©C0450070 
Courier Italic Bold 8pt 8 C0450080 
Courier Italic Bold 10pt 10 ©C0450000 
Courier Italic Bold 12pt 12 C0450080 
Courier Italic Bold 14pt 14 C04500D0 
a a 
Courier Italic Bold 20pt 20 C04500J0 


Figure 53. Courier Font Samples 
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Glossary 


advanced function printing (AFP). The ability of 
programs to use the all-points-addressable concept to 
print text and images on a printer. 


advanced function printing data stream (AFPDS). In 
AFP support, the printer data stream used for printing 
advanced function printing data. The AFPDS includes 
composed text, page segments, electronic overlays, 
form definitions, and fonts that are downloaded from 
the iSeries system to the printer. 


AFP. See advanced function printing (AFP) 


AFP resources. The form definitions, page definitions, 
fonts, overlays (electronic forms), and page segments 
(graphic images). With PrintManager, resources can 
either exist in a system library, or be placed inline with 
a print job as the job is written to the spool. 


AFPDS. See advanced function printing data stream 
(AFPDS). 


all authority. An object authority that allows the user 
to perform all operations on the object except those 
limited to the owner or controlled by authorization list 
management authority. The user can control the object’s 
existence, specify the security for the object, and change 
the object. Contrast with exclude authority. 


all-points-addressable. In AFP support, pertaining to 
the capability to address, refer to, and position text, 
overlays, and images at any defined point on the 
printable area of the paper. 


application. A particular business task, such as 
inventory control or accounts receivable. 


application program. A program used to perform a 
particular data processing task, such as inventory 
control or payroll. 


ascending sequence. The arrangement of data in 
order from the lowest value to the highest value, 
according to the rules for comparing data. Contrast 
with descending sequence. 


authorization list. A list of two or more user IDs and 
their authorities for system resources. The 
system-recognized identifier for the object type is 
*AUTL. 


bar code. A pattern of bars of various widths 
containing data to be interpreted by a scanning device. 


batch. Pertaining to a group of jobs to be run ona 
computer sequentially with the same program with 
little or no operator action. Contrast with interactive. 


batch job. A predefined group of processing actions 
submitted to the system to be performed with little or 
no interaction between the user and the system. 
Contrast with interactive job. 


bin. In AFP support, the standard-size paper source 
on the IBM 3820. 


block edit function. In AFP Utilities, a function that 
moves, copies, or removes all elements defined in a 
specified scope on the image area at one time. 


box. In AFP Utilities, a continuous line constructing a 
rectangle. 


break field. In AFP Utilities, the field which causes a 
page break. When the encounters the record whose 
value of the specified field in the record are not equal 
to that of the previous record, page break occurs. 


byte. (1) The smallest unit of storage that can be 
addressed directly. (2) A group of 8 adjacent bits. In the 
EBCDIC coding system, 1 byte can represent a 
character. In the double-byte coding system, 2 bytes 
represent a character. 


change authority. An object authority that allows a 
user to perform all operations on the object except 
those limited to the owner or controlled by object 
existence authority and object management authority. 
The user can add, change, and delete entries in an 
object, or read the contents of an entry in the object. 
Change authority combines object operational authority 
and all the data authorities. 


character. Any letter, number, or other symbol in the 
data character set that is part of the organization, 
control, or representation of data. 


character set. A group of characters used for a specific 
reason; for example, the set of characters the display 
station can display, the set of characters a printer can 
print, or a particular set of graphic characters in a code 
page; for example, the 256 EBCDIC characters. 


character string. A sequence of consecutive characters 
that are used as a value. 


characters per inch (cpi). The number of characters 
printed horizontally within an inch across a page. 


check digit. The far right number of a self-check field 
used to verify the accuracy of the field. 


CL. See control language (CL). 
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code page. (1) A particular assignment of hexadecimal 
identifiers to graphic characters. (2) In AFP support, a 
font file that associates code points and graphic 
character identifiers. 


code-page ID. A 5-digit registered identifier used to 
specify a particular assignment of code points to 
graphic characters. The code-page ID is the second part 
of the QCHRID system value or the CHRID parameter 
value. See also graphic character-set ID. 


code point. (1) One of the bit patterns assigned to a 
character in a character set. On the system, a code point 
is represented by a hexadecimal number. For example, 
in code page 256 (EBCDIC), the letter "e” is assigned a 
code point of hex 85. (2) In AFP support, an 8-bit 
binary number representing one of 256 potential 
characters. 


coded font. In AFP support, a font file that associates 
a code page and a font character set. For double-byte 
fonts, a coded font associates multiple pairs of code 
pages and font character sets. 


command. (1) A statement used to request a function 
of the system. A command consists of the command 
name abbreviation, which identifies the requested 
function, and its parameters. starts a protocol. 


command line. The blank line on a display where 
commands, option numbers, or selections can be 
entered. 


command prompt. A displayed character (or string of 
characters) that indicates that a user may enter a 
command to be processed. 


compatibility. Ability to work in the system or ability 
to work with other devices or programs. 


completion message. A message that tells the operator 
when work is successfully ended. 


concatenate. To join two character strings. 
concept. An abstract idea. 


contextual help. Help that explains the field on which 
the cursor is positioned when you press the Help key. 
Contrast with extended help. 


control field. In AFP Utilities, an input field on the 
screen view that is used to move the image are up, 
down, left, or right. 


control language (CL). The set of all commands with 
which a user requests system functions. 


control language (CL) program. A program that is 
created from source statements consisting entirely of 


control language commands. 


cpi. See characters per inch (cpi). 
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current library. The library that is specified to be the 
first user library searched for objects requested by a 
user. The name for the current library can be specified 
on the Sign-On display or in a user profile. When you 
specify an object name (such as the name of a file or 
program) on a command, but do not specify a library 
name, the system searches the libraries in the system 
part of the library list, then searches the current library 
before searching the user part of the library list. The 
current library is also the library that the system uses 
when you create a new object, if you do not specify a 
library name. 


current release. The latest available release of the 
system that replaced the licensed internal code and/or 
the operating system. 


cursor. A movable symbol, often a blinking or solid 
block of light, that tells the display station user where 
to type, or identifies a choice to select. 


data area. A system object used to communicate data, 
such as CL variable values between the programs 
within a job and between jobs. The system-recognized 
identifier for the data area is *DTAARA. 


data integrity. (1) The condition that exists as long as 
accidental or intentional destruction, alteration, or loss 
of data does not occur. (2) Within the scope of a unit of 
work, either all changes to the database management 
systems are completed or none of them are. The set of 
change operations are considered an integral set. 


data management. The part of the operating system 
that controls the storing and accessing of data to or 
from an application program. The data can be on 
internal storage (for example, database), on external 
media (diskette, tape, or printer), or on another system. 


data stream. All information (data and control 
commands) sent over a data link usually in a single 
read or write operation. 


data tower. In AFP Utilities, a set of intelligent printer 
data stream commands that represent a data type, such 
as text, image, graphics, and bar code. 


database. All the data files stored in the system. 


database file. One of several types of the system 
object type *FILE kept in the system that contains 
descriptions of how input data is to be presented to a 
program from internal storage and how output data is 
to be presented to internal storage from a program. See 
also physical file and logical file. 


DBCS. See double-byte character set (DBCS). 


DBCS conversion. A function of the operating system 
that allows a DBCS display station user to enter 
alphanumeric data and request that the alphanumeric 
data be converted to double-byte data. 


default. A value that is automatically supplied or 
assumed by the system or program when no value is 
specified by the user. 


diagnostic. Pertaining to the detection and isolation of 
an error. 


digit. Any of the numerals from 0 through 9. 


document. Any collection of text or other strings of 
data. All documents and folders on a single system 
make up the document library. A document can contain 
any type of data stored in it by an application. For 
example, the application can store notes, memos, 
reports, and other items; the shared folders application 
can store any data that could otherwise be stored in a 
PC file; an application can store any data into a 
document by using CL commands, such as FILDOC 
and RPLDOC. The system-recognized identifier for the 
document object type is *DOC. 


document name. The 1- through 12-character name for 
documents in folders, assigned by the user when 
creating the document. Contrast with library-assigned 
document name and document object name. 


double-byte character. An entity that requires two 
character bytes. 


double-byte character set (DBCS). A set of characters 
in which each character is represented by 2 bytes. 
Languages such as Japanese, Chinese, and Korean, 
which contain more symbols than can be represented 
by 256 code points, require double-byte character sets. 
Because each character requires 2 bytes, the typing, 
displaying, and printing of DBCS characters requires 
hardware and programs that support DBCS. Four 
double-byte character sets are supported by the system: 
Japanese, Korean, Simplified Chinese, and Traditional 
Chinese. Contrast with single-byte character set. 


double-byte coded font. In AFP support, a font in 
which the characters are defined by 2 bytes: the first 
defining a coded font section, the second defining a 
code point. Synonymous with double-byte font. 
Contrast with single-byte coded font. 


draft. A printed copy of a document that is not yet 
completed. 


duplex. (1) Pertaining to communications in which 
data can be sent and received at the same time. 
Contrast with half-duplex. (2) In AFP support, pertaining 
to printing on both sides of a sheet of paper. Contrast 
with simplex. 


edit. To interactively add, change, delete, or rearrange 
the data; for example, to insert or remove characters, 
sentences, or paragraphs, or to insert or remove 
characters in dates or decimal numbers. 


EIA. Electronic Industries Association. 


electronic overlay. An AFP resource object that is a 
collection of predefined data, such as lines, shading, 
text, boxes, or logos, that can be merged with variable 
data on a page while printing. The system-recognized 
identifier for the object type is *OVL. 


element. (1) In a list of parameter values, one value. 
(2) Either a bar or a space in a bar of a bar code. (3) In, 
the smallest unit, such as text, an image, or a bar code, 
used to design an AFP resource like an electronic 
overlay. See also element mark and element name. 


element mark. In AFP Utilities, a mark that is used to 
show the position of an element on a display; for 
example, ’*B005’ where B means bar code and 005 is 
the fifth element. See also element and element name. 


element name. In AFP Utilities, a name that appears 
in the image area instead of an element mark. See also 
element and element mark. 


exclude authority. An object authority that prevents 
the user from using the object or its contents. Contrast 
with all authority. 


extended help. Help that explains the purpose of the 
display. Extended help appears if the user presses the 
Help key when the cursor is outside the areas for 
which contextual help is available. Contrast with 
contextual help. 


fidelity. In AFP support, the degree of exactness 
required when processing the input data stream for 
printing a file. Different levels of fidelity can be 
specified, which determine how errors are handled 
(such as substituting fonts when a font named in the 
data stream cannot be found). 


field. A group of related bytes (such as name or 
amount) that is treated as a unit in a record. 


file. (1) A generic term for the object type that refers 
to a database file, a device file, or a save file. The 
system-recognized identifier for the object type is 
*FILE. (2) In the hierarchical file system, a piece of 
related information (data), such as a document. 


file description. The description of a file and its 
contents. 


file list. A list of files contained in a library. 


file name. The name used by a program to identify a 
file. See also label. 


file type. A data type that allows the program to read 
input and write output in &pascal. 


fixed data. In AFP Utilities, an element in the record 
layout and page layout that has a constant value. 
Contrast with variable data. 


font. (1) An assortment of characters of a given size 
and type style. (2) A particular style of type (for 
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example, Bodini or Times Roman) that contains 
definitions of character sets, marker sets, and pattern 
sets. 


font character set. In AFP support, a font file that 
contains the raster patterns, identifiers, and descriptions 
of characters. 


font ID. A number that identifies the character style 
and size for certain printers. 


font resource. A resource object on the iSeries system 
that is required to print AFPDS documents on a printer. 
The three types of font resources are coded fonts, 
character sets, and code pages. The system-recognized 
identifier for the object type is *FNTRSC. 


form. In AFP support, a physical sheet of paper on 
which data is printed. Synonymous with medium, 
physical page, and sheet. 


form definition. An AFP resource object that defines 
the characteristics of the printed media; for example, 
overlays to be used, text suppression, position of page 
data on the form, and number and modifications of a 
page. The system-recognized identifier for the object 
type is *FORMDF. 


form type. A 10-character identifier, assigned by the 
user, that identifies each type of form used for printed 
output. 


format. (1) A defined arrangement of such things as 
characters, fields, and lines, usually used for displays, 
printouts, files, or documents. (2) The arrangement or 
layout of fields in a record. (3) The arrangement or 
layout of data on a storage medium, such as disk, tape, 
or diskette. 


function. (1) Any instruction or set of related 
instructions that perform a specific operation. 


function key. A keyboard key that allows the user to 
select keyboard functions or programmer functions. 
Contrast with character key. 


GDF (Graphics Data Format). Advanced Function 
Printing Utilities can create an AFP resource, such as an 
electric overlay and the spooled file using GDF. 


general-purpose library. The library shipped with the 
system that contains IBM-provided objects required for 
many system functions and user-created objects that are 
not explicitly placed in a different library when they 
are created. Named QGPL. 


generic. Relating to, or characteristic of, a whole 
group or class. 


generic name. (1) The characters common to object 
names that can be used to identify a group of objects. A 
generic name ends with an asterisk (*). For example, 
ORD* identifies all objects whose names begin with the 
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characters ORD. (2) In the hierarchical file system, a 
path name that contains one or more wildcard 
characters. 


graphic character. A character that can be displayed or 
printed. Contrast with control character. 


graphic character set. A set of graphic characters in a 
code page. 


graphics. (1) In Advanced Function Printing Utilities, 
graphics data can be placed in a source overlay, a 
record layout, and a page layout. (2) Pictures and 
illustrations. (3) Pertaining to charts, tables, and their 
creation. 


grid. In AFP Utilities, horizontal and vertical lines 
printed on an AFP resource, such as an electronic 
overlay, to help in the design of the AFP resource. 


hardware. Physical equipment, rather than programs, 
procedures, rules, and associated information. 


hide function. In AFP Utilities, a function on the 
screen view used to display elements hidden by other 
elements that were specified after the hidden elements 
and in the same or approximate position as the hidden 
elements. 


HRI. See human readable interpretation (HRI). 


human readable interpretation (HRI). In AFP 
Utilities, the characters printed above or below a bar 
code. These characters are read by people, not by 
scanners. 


IBM Advanced Function Printing Utilities Version 2. 
The IBM licensed program that provides AFP functions 
on the iSeries system. It is composed of the following 
menu-driven interactive utilities: overlay utility, print 
format utility, and resource management utility. 


IBM iSeries Manufacturing, Accounting, and 
Production Information Control System I (MAPICS 

I). The IBM licensed program that provides a set of 
twelve integrated applications including financial, order 
processing, and manufacturing packages. 


IBM Operating System/400 Version 2 (OS/400). 
Pertaining to the IBM licensed program that can be 
used as the operating system for the system. 


IBM iSeries Access. The IBM licensed program that 
provides system functions to an attached personal 
computer. 


identifier. (1) The name of something. (2) A sequence 
of bits or characters that identifies a user, program, 
device, or system to another user, program, device, or 
system. 


image. An electronic representation of an original 
document recorded by a scanning device. 


image area. In AFP Utilities, an area on the display 
where the image of an AFP resource is displayed when 
a user designs the resource. See also key entry area. 


image data stream. An advanced function printing 
data stream that represents image data. See also [O1 
and IM1. 


Image Object Content Architecture (IOCA). A 
defined data stream used to store raster image data. 
The images in a Mixed Object: Document Content 
Architecture document are stored using IOCA. See also 
IO1 and Mixed Object:Document Content Architecture. 


IM1. A data tower of an intelligent printer data stream 
that represents image data. See also [O1. 


index search. A searchable part of the online help 
information that provides "how-to" and explanatory 
topics to supplement the help for specific displays. The 
system-recognized identifier for the object type is 
*SCHIDX. 


IMDS. The Image Data Stream (IOCA). Advanced 
Function Printing Utilities can create the page segment 
from IMDS. See image Object Content Architecture (IOCA) 
and JO1. 


input field. A field specified in a display file or 
database file that is reserved for information supplied 
by a user. Contrast with output field. 


integrity. See data integrity. 


intelligent printer data stream (IPDS). An 
all-points-addressable data stream that allows users to 
position text, images, and graphics at any defined point 
on a printed page. 


interactive. Pertaining to the dialog-like exchange of 
information between people and a computer. Contrast 
with batch. 


IOCA. See Image Object Content Architecture (IOCA). 


101. A data tower of an intelligent printer data stream 
that represents image data. Both IM1 and IO1 represent 
a raster pattern, but IO1 commands provide additional 
functions. See also IM1 and Image Object Content 
Architecture (IOCA). 


IPDS. See intelligent printer data stream (IPDS). 
job. A unit of work to be done by a computer. 


job description. A system object that defines how a 
job is to be processed. The object name is *JOBD. 


job log. A record of requests submitted to the system 
by a job, the messages related to the requests, and the 
actions performed by the system on the job. The job log 
is maintained by the system program. 


job name. The name of the job as identified to the 
system. For an interactive job, the job is assigned the 
name of the work station at which the job was started; 
for a batch job, the name is specified in the command 
used to submit the job. Contrast with qualified job name. 


Kanji. Characters originating from the Chinese 
characters used in the Japanese written language. 


key entry area. In AFP Utilities, an area shown at the 
lower part of the image area for entering the 
parameters for an element. See also image area. 


label. (1) The name of a file on a diskette or tape. (2) 
An identifier of a command or program statement 
generally used for branching. 


leader. The blank section of tape at the beginning of a 
reel. 


library. (1) A system object that serves as a directory 
to other objects. A library groups related objects, and 
allows the user to find objects by name. The 
system-recognized identifier for the object type is *LIB. 
Compare with folder and document library. (2) The set of 
publications for a system. 


library list. A list that indicates which libraries are to 
be searched and the order in which they are to be 
searched. The system-recognized identifier is *LIBL. 


library name. A user-defined word that names a 
library. 


licensed program. A separately orderable program, 
supplied by IBM, that performs functions related to 
processing user data. Examples of licensed programs 
are ,,,, and so on. 


lines per inch (lpi). The number of characters that can 
be printed vertically within an inch. 


list view. In AFP Utilities, the presentation of a 
display shown while a user is in list edit mode. See 
also screen view. 


logo. (1) A letter, combination of letters, or symbol 
used to represent an entire word (abbreviation for 
logogram). (2) The display that identifies the IBM 
Corporation and the program name on licensed 
programs. 


Ipi. See lines per inch (lpi). 
mapping. A representation of one thing to another. 


mapping object. A function of to map a database field 
value to an object name. 


mark. See element mark. 


matrix. An arrangement in rows and columns. 
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member. Different sets of data, each with the same 
format, within one database file. See also source member. 


menu. A displayed list of items from which a user can 
make a selection. The system-recognized identifier for 
the object type is *MENU. 


merge. (1) To insert records throughout a single 
output file. (2) To combine overrides for a file from the 
first call level up to and including a greater call level, 
producing the override to be applied when the file is 
used. 


message. A communication sent from a person or 
program to another person or program. 


message line. An area on the display where messages 
are displayed. 


message queue. A list on which messages are placed 
when they are sent to a user ID or device description. 
The system-recognized identifier for the object type is 
*MSGQ. 


migration. The process of moving data and source 
from one computer system to another without 
converting the data. 


module width. In AFP Utilities, the basic element 
width used in a bar code. The actual code element may 
be a module width or a multiple of a module width. 


object. A named storage space that consists of a set of 
characteristics that describe itself and, in some cases, 
data. An object is anything that exists in and occupies 
space in storage and on which operations can be 
performed. Some examples of objects are programs, 
files, libraries, and folders. 


object description. The characteristics (such as name, 
type, and owner name) that describe an object. 


object existence authority. An object authority that 
allows the user to delete the object, free storage of the 
object, save and restore the object, transfer ownership 
of the object, and create an object that was named by 
an authority holder. 


object operational authority. An object authority that 
allows the user to look at the description of an object 
and use the object as determined by the user’s data 
authorities to the object. See also all authority and use 
authority. 


offset. The distance from the beginning of an object to 
the beginning of a particular field, or for substring 
operations, the number of character positions from the 
beginning of a field. 


online information. Information on the display screen 
that explains displays, messages, and programs. 


operation. The result of processing statements in a 
high-level language. 
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output. Information or data received from a computer 
that is shown on a display, printed on the printer, or 
stored on disk, diskette, or tape. 


output queue. An object that contains a list of spooled 
files to be written to an output device, such as a printer 
or a diskette. The system-recognized identifier for the 
object type is *OUTQ. 


overlay. (1) To write over (and therefore destroy) an 
existing file. (2) A program segment that is loaded into 
main storage and replaces all or part of a previously 
loaded program segment. (3) For AFP support, see 
electronic overlay. 


overlay utility. In AFP Utilities, an interactive tool that 
allows the user to create an overlay. 


override. (1) To specify attributes at run time that 
change the attributes specified in the file description or 
in the program. (2) The attributes specified at run time 
that change the attributes specified in the file 
description or in the program. 


overstrike. Pertaining to a character or symbol that 
occupies the same space as another character or 
symbol. 


owner. The user who creates an object (or is named 
the owner of an object). 


page. (1) One printer form. (2) To move information 
up or down on the display. 


page break. In AFP Utilities, there is the field which 
causes a page break. When the encounters the record 
whose value of the specified field in the record are not 
equal to that of the previous record, the prints the 
record on a new page. This condition is called as ‘page 
break’. 


page down. To move up the data shown on the 
display, which allows the user to move toward the end 
of the data. Contrast with page up. 


page layout. In AFP Utilities, a printout format of a 
page in the printout format definition (PFD). By using 
the print format utility, the user can design the page 
layout by placing and repeating a predefined record 
layout with constant data. See also record layout. 


page segment. An AFP resource object that can 
contain text and images and can be positioned on any 
addressable point on a page or an electronic overlay. 
The system-recognized identifier for the object type is 
*PAGSEG. 


page up. To move down the data shown on the 
display, which allows the user to move toward the 
beginning of the data. Contrast with page down. 


panel. In UIM, a visual presentation of data on the 
screen. 


parameter. A value supplied to a command or 
program that is used either as input or to control the 
actions of the command or program. 


parity. The state of being either even-numbered or 
odd-numbered. A parity bit is a binary number added 
to a group of binary numbers to make the sum of that 
group either always odd (odd parity) or always even 
(even parity). 


PC file. A file stored on a personal computer. 


pending. Pertaining to a request that was submitted 
and that is awaiting processing. 


PFD. See printout format definition (PFD). 
PFU. See print format utility (PFU). 


place operation. In AFP Utilities, an operation that 
defines a page segment or a record layout in an AFP 
resource. 


point. (1) The second byte of a DBCS code, which 
uniquely identifies double-byte characters in the same 
ward. Contrast with ward. (2) In AFP support, a unit of 
measurement used mainly for describing type sizes. 
Each pica has 12 points, and an inch has approximately 
72 points. 


print format utility (PFU). In AFP Utilities, a utility 
that allows a user to print a database file member in 
various formats without writing any programs. 


print text. An option that allows the user to specify a 
line of text at the bottom of a list. 


printer file. A device file that determines what 
attributes printed output will have. A particular printer 
may or may not support all of the attributes specified 
in a printer file. 


printer writer. A system program that writes spooled 
files to a printer. 


printout format definition (PFD). In AFP Utilities, a 
file member that contains information about the record 
layout, page layout, record selection, and database file 
name. A PFD is used to print the records of a database 
file member in various formats. 


private authority. The authority specifically given to a 
user for an object that overrides any other authorities, 
such as the authority of a user’s group profile or an 
authorization list. Contrast with public authority. 


problem analysis. The process of finding the cause of 
a problem. For example, a program error, device error, 
or user error. 


program. A sequence of instructions that a computer 
can interpret and run. 


prompt. A reminder or a displayed request for 
information or user action. The user must respond to 
allow the program to proceed. 


public authority. The authority given to users who do 
not have any specific (private) authority to an object, 
who are not on the authorization list (if one is specified 
for the object), and whose group profile has no specific 
authority to the object. Contrast with private authority. 


QGPL. See general-purpose library. 


qualified name. The name of the library containing 
the object and the name of the object. Contrast with 
object name. 


queue. A list of messages, jobs, files, or requests 
waiting to be read, processed, printed, or distributed in 
a predetermined order. 


read authority. A data authority that allows the user 
to look at the contents of an entry in an object or to run 
a program. See also add authority, delete authority, and 
update authority. 


record. A group of related data, words, or fields 
treated as a unit, such as one name, address, and 
telephone number. 


record format. A named part of a file that identifies 
records of a specified record format description. 


record layout. In AFP Utilities, a part of the printout 
format definition that defines how each field of a 
database file record is formatted and printed by the 
print format utility. See also page layout. 


record selection. The process of selecting particular 
records from a file and including the information from 
the records, for example, in a report. 


remote. Pertaining to a device, system, or file that is 
connected to another device, system, or file through a 
communications line. Contrast with local. 


reserved variable data. The following data is called as 
‘reserved variable data’, and can be printed as text on 
the record layout in the same manner as printing 
variable data from the database file. 


* Job date 

* Job time 

¢ Page number 

* Record number 

* Database file name 
¢ Library name 


¢ Member name 


resolution. In computer graphics, a measure of the 
sharpness of an image, expressed as the number of 

lines per unit of length or the number of points per 
unit of area discernible in that image. 
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resource. Any part of the system required by a job or 
task, including main storage, devices, the processing 
unit, programs, files, libraries, and folders. 


resource management utility (RMU). In AFP Utilities, 
an interactive tool used to maintain AFP resources. 


resource name. A name assigned by the system to a 
line, controller, or device that is connected to the 
system. 


restore. To copy data from tape, diskette, or a save file 
to auxiliary storage. Contrast with save. 


RMU. See resource management utility (RMU). 


save. To copy specific objects, libraries, or data by 
transferring them from main or auxiliary storage to 
magnetic media such as tape, diskettes, or a save file. 
Contrast with restore. 


SBCS. See single-byte character set (SBCS). 


screen view. In AFP Utilities, the presentation of a 
display shown while a user is in screen edit mode. See 
also list view. 


sequence number. (1) The number of a record that 
identifies the record within the source member. (2) A 
field in a journal entry that contains a number assigned 
by the system. This number is initially 1 and is 
increased by 1 until the journal is changed or the 
sequence number is reset by the user. 


session. The length of time that starts when a user 
signs on at a display station and ends when the user 
signs off. location. 


simplex. In AFP support, pertaining to printing on 
only one side of the paper. Contrast with duplex. 


single-byte character set (SBCS). A character set in 
which each character is represented by a one-byte code. 
Contrast with double-byte character set. 


single-byte coded font. In AFP support, a font in 
which the characters are defined by a 1-byte code 
point. A single-byte coded font has only one coded font 
section. Synonymous with single-byte font. Contrast 
with double-byte coded font. 


source overlay. In AFP Utilities, a file member that 
contains the definition of an overlay. 


specific authority. The types of authority a user can 
be given to use the system resources, including object 
authorities and data authorities. See also object authority 
and data authority. Contrast with special authority. 


spool. The system function of putting files or jobs into 
disk storage for later processing or printing. 
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spooled file. A file that holds output data waiting to 
be processed, such as information waiting to be 
printed. Also known as spooled output file. 


step. To cause a computer to run one operation. 
store. To put or keep data in a storage device. 


summary data. The following data is called as 
‘summary data’: 


¢ The field value of the first record in the group. 

° The field value of the last record in the group. 

° The total of the field values in the group. 

¢ The average of the field values in the group. 

¢ The minimum field value in the group. 

* The maximum field value in the group. 

* The record counts of the group. 

They can be printed on the following element in the 
page layout: 

° Text data on text element 


¢ Text data on box element 


syntax. The rules for constructing a command or 
statement. 


system unit. A part of a computer that contains the 
processing unit, and may contain devices such as disk 
units and tape units. 


table. An orderly arrangement of data in rows and 
columns that can contain numbers, text, or a 
combination of both. The system-recognized identifier 
for the object type is *TBL. 


use authority. An object authority that allows the user 
to run a program or to display the contents of a file. 
Use authority combines object operational authority 
and read authority. 


variable data. In AFP Utilities, an element in the 
record layout whose value is represented in the 
database file. Contrast with fixed data. 


wide-to-narrow ratio. In AFP Utilities, the ratio of the 
wide element dimension to the narrow element 
dimension of a bar code. See also element. 
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Convert Page Segment to PFM 
display 357, 358 
Convert PCD to Page Segment 
(CVTPCDPAGS) display 324, 325, 
326 
Convert PFM to Page Segment 
(CVTPFMPAGS) display 326, 327 
Convert to Page Segment 
display 316, 317, 331, 332, 333, 335 
Copy PFD Definition display 198 
Copy PFD Definition File 
display 212 
Copy Source Overlay display 77 
Copy Source Overlay File display 92 
Create Overlay display 47, 54, 80 
Create PFD Definition display 131 
Create PFD Definition File 
display 108 
Create PFD Definition Files 
display 209 
Create PFD Definitions display 110, 
147 
Create Source Overlay display 33, 
46, 65 
Create Source Overlay File 
display 32, 89, 91 
Create Source Overlays display 33 
Define Bar Code Detail display 265 
Define Box Detail display 254, 255 
Define Line Detail display 251 
Define Overlay Specifications 
display 66 
Define PFD Specifications 
display 149, 150 
Define Printout Specifications 
display 130, 131, 187 
Define Summary Data display 181 
Define Text Detail display 116, 117 
design display 16, 228, 229 
list view 229 
screen view 229 
Design Overlay display 35, 36, 37, 
38, 39, 40, 41, 42, 43, 44, 45, 51, 52, 
230, 240, 242, 243, 250, 252, 263, 273, 
278, 279, 288, 289, 290, 291, 292 
Design Page Layout display 127, 128, 
129, 130, 169, 170, 171, 175, 176, 284 
Design Record Layout display 112, 
114, 115, 118, 119, 120, 121, 122, 123, 
125, 126, 162, 166 
Display PFD Definition Font 
display 304, 305, 306 
Edit Numeric display 168 
Exit Definition display 132 
Exit Overlay Utility display 46, 53, 
73 
Exit PFD Definition display 194 
fonts 304 
help 19 
IBM Advanced Function Printing 
Utilities for iSeries display 15, 30, 
49, 59, 106, 135, 139, 221, 315, 323 
iSeries Main Menu display 223 
Mapping Page Segment Name 
display 192 
menu display 14 
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overlay description 312, 346 
page segment description 312, 356 
PFD definition file description 214 
Place Graphics Detail display 281 
Place Page Segment Detail 
display 275 
Place Record Layout Detail 
display 128, 173, 174, 285 
Print Database File Member 
display 134, 136, 216, 220, 221 
Print Overlay display 319, 345 
Print Page segment display 322 
Print Page Segment display 355 
Print PFD Data (PRTPFDDTA) 
display 223 


Save PFD Definition display 132, 195 


Save Source Overlay display 47, 54, 
74 
Select Database File display 159 
Select Database File Member 
display 219 
Select Field in Record Format 
display 117, 164, 276, 283 
Select Fields to Edit Numeric 
display 169 
Select Page Segment display 276 
Select PFD Definition display 137, 
222 
Select PFD Definition File 
display 221 
Select Record Format display 160 
Select Reserved Variable Name 
display 164 
Select Source Overlay Font 
display 249 
source overlay file description 94 
Specify Break Fields display 161 
Specify Database File display 110, 
111, 158 
Specify Element Selection 124 
Specify Mapping Object Name 
display 191 
Specify Record Selection display 183 
work with display 15 
Work with Overlays display 318, 
319, 341 
Work with Page Segments 
display 321, 351 
Work with PFD Definition Files 
display 107, 203, 205 
Work with PFD Definition Fonts 
display 297 
Work with PFD Definitions 
display 109, 133, 135, 143, 196, 215 
Work with Source Overlay 
display 48 
Work with Source Overlay Files 
display 31, 48, 83, 85 
Work with Source Overlay Fonts 
display 297 
Work with Source Overlays 
display 33, 50, 55, 61 
display a page segment description 312 
display an overlay description 312 
display description of PFD definition 
file 214 


display description of source overlay 
file 94 

DMAS forms 459 

duplex 188 


E 


EAN-13 264 
EAN-8 264 
edit 


element 288, 295 
element operations 234 
EIA (Electronic Industries Association) 
labels 461 
element 14, 100 
bar code 42, 263, 413 
block edit 289 
box 39, 252, 411 
format 419 
rotation 420 
shading 435 
text placement 419 
change 239, 294 
change in list view 291 
confirm delete 72 
copy 288 
create 294 
define 239 
edit 288, 295 
graphic 43, 277 
graphics 415 
line 38, 249, 409 
move 288 
page segment 273, 414 
record layout 284, 414 
remove 288 
text 35, 242, 408 
element list 
copy 295 
move 295 
remove 295 
restore 295 
sort 295 
element mark 231 
hide 232 
on/off 232 
refresh 232 
scroll 232 
element operations 
change 234 
define 233 
edit 234 
screen view 233 
element position 408 
element position limitations 391, 395 
element selection 
specify 123 
element type 227, 408 
bar code 227 
box 227 
line 227 
page segment 227 
record layout 228 
text 227 
element type and position (problem 
analysis) 408 
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end 
overlay utility 60 
print format utility 135, 141 
resource management utility 329 
end overlay utility 60 
end print format utility 135 
end resource management utility 329 
enlarge character size 248 


EQ 185 
equal (=) sign 290 
exit 


defining PFD definition 131 
design record layout 126 


F 


field 185 
file 14 
fixed text data 
specify 114 
font 
change 300 
display 304 
restrictions 392, 395 
set initial 306 
work with 297 
font samples 465 
Courier 466 
Helvetica Roman Bold 466 
Times New Roman Medium 465 
format ina box 417 
formatting examples 262 
function keys 17 
page down 235 
page up 235 
roll down 235 
rollup 235 
function keys on design display 235 


G 


GDF 393, 397, 439 
create 439 
GE 185 
getting started 
overlay utility 27 
print format utility 104 
resource management utility 313 
graphic 
control 280 
degree of rotation 282 
element name 282 
end position 280, 282 
folder 280, 282 
font 282 
mark 280, 282 
measurement method 280, 282 
rotation 437 
start position 280, 282 
graphics (GDF) size 
restrictions 393, 397 
graphics element and position 415 
measurement method 415 
grid (overlay specifications) 69 
grid (PFD specifications) 153 
GT 185 


H 


hardware requirements 13 
height (overlay specifications) 68 
height (PFD specifications) 152 
help 
control language commands 19 
display 19 
hide element mark 232 
how to doa task 443 


identifying problems 399 

image area 16, 230 

IMDS (IOCA) data stream 
restrictions 397 

infoseeker 19 

IOCA data stream 397 

IPDS towers 457 


J 


JAN-short 264 
JAN-standard 264 
JPBC 264 


K 


key entry area 16, 230 


L 


label 
sample 10 
layout of list view 291 
layout of screen view 230 
LE 185 
library 14 
limitations 391 
overlay utility 391 
print format utility 394 
printer storage 417 
resource management utility 397 
line 
restrictions 393, 396 
line element 
border 252 
control 250 
element 252 
end position 251 
mark 250, 251 
measurement method 250, 251 
placement 252 
specify 125 
start position 250 
type 252 
width 252 
line element and position 409 
measurement method 409, 411 
line width and overlay size 391 
line width and page size 
limitations 394 


lines per inch (overlay specifications) 67 


lines per inch (PFD specifications) 152 
list view 229 
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list view (continued) 
control 292 
ID 293 
layout 291 
M 293 
NAME 293 
NBR_ 293 

LT 185 


MAPICS/DB forms 460 
mapping object name 100 
specify 191 
mapping option 
Center-and-trim 336 
Image point-to-pel 336 
Image point-to-pel with double 
dot 336 
Position and trim 336 
Scale-to-fit 336 
measurement method (overlay 
specifications) 68, 69 
measurement method (PFD 
specifications) 152, 153 
member 14 
menu display 14 
minimum and maximum 
limitations 394 
move 
element 288 
element list 295 
MSI 264 


N 


NE 185 
numeric editing 167 


O 


offset (overlay specifications) 69 
offset (PFD specifications) 152 
omit back side page layout 189 
online information 19 
operation flow 26, 102 
overlay 23 
convert 312 
convert to (physical file member) 
copy 311 
create 80 
delete 311, 343 
print 57, 312, 318, 344 
rename 311, 346 
sample 9, 24 
using 56 
work with 311 
overlay description 
change 312 
display 312, 346 
overlay object 
authority 394 
copy 343 
overlay object authority 
restrictions 394 
overlay specifications 24 


overlay specifications (continued) 
change 70 
characters per inch 67 
DBCS SO/SI spacing 68 
define 66 
degree of rotation 67 
design 25 
fonts 24 
grid 69 
height 68 
lines per inch 67 
measurement method 68, 69 
offset 69 
printer type 67 
size 68 
unit of measure 68 
width 68 
overlay text 
change 349 
overlay utility 9 
create 33 
end 57 
getting started 27 
introduction 23 
limitations 391 
dashed and dotted lines 391 
element position 391 
line width and overlay size 391 
minimum and maximum 391 
operation flow 26 
restrictions 392 
box 393 
font 392 
graphics (GDF) size 393 
line 393 
overlay object authority 394 
page segment 392 
printer dependencies 394 
shading ina box 393 
source overlay file 392 
text font in graphics (GDF) 393 
text ina box 393 
source overlay 24 
overlay specifications 24 
start 30,57 
override a printer file 56 
overstrike 247, 260 


Pp 


page layout 99 
design 126, 169 
page number (PFD specifications) 152 
page segment 8 
convert 313 
convert form (database file) 309 
convert from (PC document) 310 
convert to 356 
copy 312 
delete 312 
mark 275 
measurement method 275 
place 49 
position 275 
print 312, 320, 355 
rename 312, 356 
restrictions 392, 396 


page segment (continued) 
specify 119 
work with 312 
page segment description 
display 312, 313, 356 
page segment element and position 414 
measurement method 414 
page segment function 324, 330 
convert to 330 
copy 354 
delete 354 
work with 349 
page segment text 
change 360 
PC document 
convert 316 
percent (%) mark 231 
PFD definition 97 
change 197 
copy 198 
create 109, 147 
database file 98 
delete 200 
elements 100 
mapping object name 100 
page layout 99 
PFD definition fonts 98 
PFD specifications 97 
print 201 
print format utility 101 
printout specifications 100 
record layout 98 
record selection 100 
rename 201 
save 194 
send 398 
work with 140, 141, 214 
PFD definition file 
change 211 
copy 212 
create 107, 209 
delete 213 
rename 214 
restrictions 395 
work with 140 
PFD definition file description 
display 214 
PFD definition file list 
select 208 
show 208 
PFD definition files 
work with 201 
PFD definition fonts 98 
work with 158 
PFD definition list 
select 146 
show 146 
PED specifications 97 
change 154 
characters per inch 151 
DBCS SO/SI 152 
define 149 
degree of rotation 152 
grid 153 
height 152 
lines per inch 152 
measurement method 152, 153 


PED specifications (continued) 
offset 152 
page number 152 
printer type 151 
size 152 
unit of measure 152 
width 152 
physical file member 312, 313 
place 
graphic element 43 
page segment 49 
portability 
fonts 458 
page segments 458 
restrictions 457 
portability to other systems 457 
print 
AFP utilities tutorial 140 
AFP Utilities tutorial 136 
database file 134, 201 
database file member 140 
overlay 57, 312, 318, 344 
page segment 312, 320, 355 
PFD definition 201 
source overlay 80 
print a page segment 312 
print AFP Utilities tutorial 136 
print an overlay 312 
print database file 134, 201 
print database file member 214 
print form 23 
print format utility 10, 97 
end 135, 137 
getting started 104 
introduction 97 
limitations 394 
dashed and dotted lines 394 
element position 395 
line width and page size 394 
minimum and maximum 394 
restrictions 395 
box 396 
font 395 
graphics (GDF) size 397 
line 396 
page segment 396 
PFD definition file 395 
printer dependencies 397 
shading ina box 397 
text font in graphics (GDF) 397 
text ina box 396 
start 106, 137 
print from 
AFP Utilities menu 221 
Work with PFD Definitions 
display 215 
print on both sides 188 
print operation 
restrictions 397 
print PFD definition 201 
print source overlay 80 
print with format utility 101 
printable area 417 
printer characteristics 417 
printer dependency restrictions 394, 397 
printer file 56 
printer storage limitations 417 
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printer type (overlay specifications) 67 
printer type (PFD specifications) 151 
printout format definition 97 
database file 98 
elements 100 
mapping object name 100 
page layout 99 
PFD definition fonts 98 
PFD specifications 97 
print format utility 101 
printout specifications 100 
record layout 98 
record selection 100 
printout specifications 100 
define 130, 187 
problem analysis 399 
identifying problems 399 
problems 
common symptoms 403 
possible causes 403 
prompts 15 
PRTPFDDTA command 222, 367 
COPIES parameter 371 
DRAWER parameter 370 
ENDPAGE parameter 370 
FILE parameter 369 
FORMDF parameter 372 
GRID parameter 370 
MBR parameter 370 
OUTBIN parameter 371 
OUTQ parameter 371 
PFDFILE parameter 368 
PFDMBR parameter 369 
RCDSLT parameter 370 
PSF (Print Service Facility) 458 
PT2 tower (underline and 
overstrike) 457 


R 


RANGE _ 185 
record format 
select 160 
record layout 98 
control 285 
design 111, 162 
mark 285 
measurement method 285 
position 285 
record layout element and position 414 
measurement method 414 
record selection 100 
specify 183 
refresh 
element mark 232 
remove 
element 288 
element list 295 
rename 
overlay 311, 346 
page segment 312, 356 
PFD definition 201 
PFD definition file 214 
source overlay 80 
source overlay file 94 
rename a page segment 312 
rename PFD definition 201 


rename PFD definition file 214 
rename source overlay 80 
rename source overlay file 94 
renaming an overlay 311 
repetition of the record in the page 172 
requirements 
hardware 13 
software 13 
resource management utility 12 
CVTOVLPFM command 328 
CVTPAGSPFM command 329 
CVTPCDPAGS command 324 
CVTPFMPAGS command 326 
end 322 
getting started 313 
introduction 309 
limitations 397 
restrictions 397 
convert a page segment 398 
convert an overlay 397 
create page segment 397 
IMDS (IOCA) data stream 397 
print operations 397 
start 315, 322 
STRAFPU Command 323 
restore 
element list 295 
restrictions 391 
overlay utility 392 
print format utility 395 
resource management utility 397 
rotation ina box 417 
rotation of graphics 437 


S 


sample label 10 
sample overlay 9, 24, 459 
DMAS forms 459 
MAPICS/DB forms 460 
sample PFD definitions 460 
AFP Utilities tutorial PFD 
definitions 461 
AIAG (Automotive Industry Action 
Group) labels 461 
EIA (Electronic Industries Association) 
labels 461 
save 
PFD definition 194 
source overlay 46, 73 
save PFD definition 194 
save source overlay 46, 73 
screen view 229 
defining elements 229 
element operations 233 
layout 230 
scroll 
element mark 232 
select 
database file 159 
PFD definition file list 208 
PFD definition list 146 
record format 160 
source overlay file 88 
source overlay list 64 
select database file 159 
select record format 160 
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selecting a PFD definition file from a 
list 208 
send 
PFD definition 398 
source overlay 398 
sense codes 406 
possible causes 406 
service representative 407 
set 
fonts 306 
shading in a box 
restrictions 393, 397 
shading pattern 257 
shading pattern ina box 417 
shading type 257 
show 
PFD definition file list 208 
PFD definition list 146 
source overlay file list 87 
source overlay list 64 
size (overlay specifications) 68 
size (PFD specifications) 152 
software requirements 13 
sort 
element list 295 
source drawer 218 
source overlay 24 
change 49, 76 
copy 77 
create 65 
delete 79 
design overlay 25 
overlay fonts 24 
overlay specifications 24 
print 80 
rename 80 
save 46, 73 
send 398 
work with 94 
source overlay file 


copy 92 
create 31, 89 
delete 93 


rename 94 
restrictions 392 
select 88 
work with 82 

source overlay file description 
change 91 
display 94 

source overlay file list 
show 87 

source overlay list 
select 64 
show 64 

specify 
bar code element 120 
box element 122 
break fields 161 
database file 110, 158 
element selection 123 
fixed text data 114 
line element 125 
mapping object name 191 
page segment 119 
record selection 183 
variable text data 116 


specify break fields 161 
specify database file 158 
specify mapping object name 191 
specify record selection 183 
start 
CVTOVLPFM command 328 
CVTPAGSPFM command 329 
CVTPCDPAGS command 324 
CVTPFMPAGS command 326 
overlay utility 30, 59 
print format utility 106, 139 
resource management utility 315, 323 
STRAFPU Command 323 
start overlay utility 59 
STRAFPU command 363 
FILE parameter 364 
MBR parameter 365 
OPTION parameter 365 
STRAFPU Command 
resource management utility 323 
STROVLU (Start Overlay Utility) 
command 363 
STRPFU command 365 
OPTION parameter 367 
PFDFILE parameter 366 
PFDMBR parameter 367 
summary data 178 
*AVG 181 
*CNT 181 
*FIRST 181 
*LAST 181 
*MAX 181 
*MIN_ 181 
*TOTAL 181 
supported printers 417 
symptom 
bar code is not printed 404 
character size is not as expected 405 
different image (page segment) is 
printed 405 
element position is not as 
expected 405 
font is not as expected 405 
graphics is not printed 404 
image (page segment) is not 
printed 404 
length of dotted or dashed line is not 
correct 405 
nothing is printed 403 
one or more elements are not 
printed 404 
page number is not printed 403 
shading in the box element is not 
correct 406 
text in a box is not formatted 
correctly 405 
text in graphics is not as 
expected 405 
text is not as expected 405 
text lines overlap 405 


7 


tasks 443 
related to break fields 456 
related to database file selection 454 
related to element 450 


tasks (continued) 
related to font 455 
related to list view of design 
display 449 
related to mapping object 456 
related to overlay objects 446 
related to overlay specifications 454 
related to page segments 446 
related to PFD definition files 445 
related to PFD definitions 444 
related to PFD specifications 454 
related to printout specifications 456 
related to record selection 454 
related to screen view of design 
display 447 
related to source overlay files 444 
related to source overlays 443 
TEST 
EQ 185 
GE 185 
GT 185 
LE 185 
LT 185 
NE 185 
RANGE 185 
text 
character size 248 
color 246 
control 243 
DBCS font 247 
degree of rotation 246 
font 247 
format 246 
height 248 
mark 243, 245 
measurement method 243, 245 
overstrike 247 
position 243, 245 
text data 244, 245 
underline 247 
width 248 
text element and position 408 
measurement method 408 
text font in graphics (GDF) 
restrictions 393, 397 
text in a box 
restrictions 393, 396 
trailing spaces 269 
tutorial 136, 140 
type (element) 227 


U 


underline 247, 260 
unit of measure (overlay 
specifications) 68 

unit of measure (PFD specifications) 152 
use 

bar code 8 

graphics 8 

images 8 

overlay 7 

printer file 56 
using an overlay 56 
using GDFs 439 


V 


value 186 

variable text data 
specify 116 

view 
layout of the list view 291 
layout of the screen view 230 
overlay with AFP Workbench 45 


W 


width (overlay specifications) 68 
width (PFD specifications) 152 
work with 
fonts 297 
overlay 311 
overlays function 324, 341 
page segment 312 
page segment function 324, 349 
PFD definition 140, 141, 214 
PFD definition file 140 
PFD definition files 201 
PFD definition fonts 158 
source overlay 60, 94 
source overlay files 60, 82 
source overlay fonts 73 
work with display 15 
work with fonts 297 
work with overlays 311 
work with overlays function 324, 341 
work with page segments 312 
work with PFD definition files 201 
work with PFD definition fonts 158 
work with PFD definitions 214 
work with source overlay files 82 
work with source overlay fonts 73 
work with source overlays 60, 94 
work with source overlays file 60 
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